iamroq.dev valid

Hello, world! I'm Roq — a funny little SSG (Static Site Generator) with a Java soul and Quarkus energy — Open Source and Free.

An Open Source static site generator (SSG) that makes it fun and easy to build websites and blogs. It's built with Java and Quarkus under the hood.

For agents: Roq, an open-source Java/Quarkus static site generator for websites and blogs. Docs cover migrating Jekyll or Hugo sites, Tailwind, Svelte and Sass integration,

static site generatorjavaquarkusjekyll migrationtailwind css

Their llms.txt

The beginning of the file, from our validated copy saved 2026-10-27T09:54:25.303Z. Cached copy · Source on iamroq.dev

## Using Roq (copy this section to your project's CLAUDE.md / AGENTS.md)

Roq is a static site generator built on Quarkus. It uses the Qute template engine with FrontMatter headers (YAML between `---` delimiters).

### Quick Start

1. Install via JBang: `curl -Ls https://sh.jbang.dev | bash -s - app install --fresh --force roq@quarkiverse/quarkus-roq`
2. Create a site: `roq create my-site` (adds the default theme with example content)
3. Start dev mode: `cd my-site && roq start` (live-reload on http://localhost:8080, most changes are picked up automatically, use `-p 9090` for a custom port, press `s` to force a soft restart if needed)
4. Build static site: `roq generate` (output in `target/roq/`), preview with `roq serve`
5. Add a plugin or theme: `roq add plugin:tagging`, `roq add theme:default`
6. Update to latest versions: `roq update`

For a minimal HTML structure without the default theme: `roq create my-site -x theme:base`. Use `--no-code` to skip example content, `--gradle` for Gradle.

Available commands: `roq create`, `roq start`, `roq generate`, `roq serve`, `roq add`, `roq update`, `roq blog`. There is NO `roq dev` command, use `roq start` for dev mode.

### AI Agent Integration (Quarkus Agent MCP)

AI coding agents (Claude Code, VS Code Copilot, Cursor, etc.) can manage Roq dev servers using [Quarkus Agent MCP](https://github.com/quarkusio/quarkus-agent-mcp). It handles lifecycle (start, stop, soft restart via `s`), log capture, and proxies to Dev MCP tools in the running app.

**Install via JBang:**
```
jbang app install --fresh --force quarkus-agent-mcp@quarkusio
```

**Configure in Claude Code:**
```
claude mcp add quarkus-agent -- jbang quarkus-agent-mcp@quarkusio
```

**Configure in VS Code / Cursor (`.vscode/mcp.json`):**
```json
{
  "servers": {
    "quarkus-agent": {
      "type": "stdio",
      "command": "jbang",
      "args": ["quarkus-agent-mcp@quarkusio"]
    }
  }
}
```

Once configured, the agent uses `quarkus_start` to launch the Roq dev server, `quarkus_restart` for soft restart, `quarkus_logs` to read output, and `quarkus_searchTools` / `quarkus_callTool` to interact with the running app.

### Directory Structure

```
my-site/
├── content/           # Pages, collections (posts/, etc.), index.html (required)
├── templates/
│   ├── layouts/       # Page layouts (page.html, post.html)
│   └── partials/      # Reusable template fragments
├── data/              # Structured data files (YAML/JSON), accessible via {=cdi:filename.property}
├── public/            # Static assets served as-is (images, PDFs)
├── web/               # JS/CSS sources (bundled by Quarkus Web Bundler)
└── config/
    └── application.properties  # Site config with site.* prefix
```
…

Related sites

Explore similar publishers →

Similar publisher descriptions and documentation. Similarity does not imply affiliation or equivalent capabilities.

Machine-readable: GET /v1/resolve?q=iamroq.dev · GET /v1/domain/iamroq.dev · this page as Accept: application/json or text/markdown · MCP lookup_domain

Automatically discovered from public files. Inclusion does not imply endorsement or publisher participation.

Claim my listing on Agent Web Map for iamroq.dev:
1. POST https://agentwebmap.com/v1/sites/iamroq.dev/claims and keep claim_id and claim_secret private.
2. Publish the verification line "AgentWebMap verification: <token>" (token from step 1) in https://iamroq.dev/llms.txt, or use the DNS, meta-tag or well-known method the response describes. This only verifies the listing; your website and domain remain yours.
3. POST https://agentwebmap.com/v1/sites/iamroq.dev/verify with {"claim_id": "...", "claim_secret": "..."}.
4. Save the api_key from the answer; it manages the listing (PATCH https://agentwebmap.com/v1/sites/iamroq.dev).
MCP equivalent: tools begin_ownership_claim, then verify_domain, at https://agentwebmap.com/mcp. Docs: https://agentwebmap.com/docs#verify

Corrections or removal requests: contact the directory.