Roq 2.1 is here!

roq-2.1 (3 Parts Series)

1 Roq 2.1 is here!
2 Set It in Roq: The Editor that changes the game!
3 GFM Alert Blocks: Styled Callouts in Your Markdown

Hello fellow Roqers,

Roq 2.1 is officially out, and it's packed with features that make content creation smoother, the developer experience richer, and the tooling more powerful than ever.

This release is big enough that we're covering it as a series of posts. We already published posts about the built-in editor and GFM alert blocks, and this post gives you the full picture of everything else that landed.

The highlights

Here's what's new in Roq 2.1:

Built-in Content Editor with rich text, Markdown support, and image upload
GFM Alert Blocks (NOTE, TIP, WARNING, CAUTION, IMPORTANT) with icons and themed colors
Standalone Roq CLI powered by Quarkus Picocli
LLMs.txt generation for AI discoverability
Custom error pages with source info and hints in dev mode
Default theme with TailwindCSS and zero configuration
Raclette link checker integration in roq-testing
RSS content modes (full content or word-limited abstracts)
Dynamic pages from data collections
Qute alternative expression syntax support
Simplified layout resolution with theme-layout support

The Roq CLI

Roq now ships as a standalone CLI tool, no Maven or Gradle knowledge required:

roq create my-blog
cd my-blog
roq

That's it. The CLI handles project creation, dev mode, static generation, plugin management, and updates. It's built as a Quarkus Picocli application and distributed via JBang.

LLMs.txt

Roq can auto-generate /llms.txt and /llms-full.txt following the llms.txt specification. AI systems like ChatGPT, Claude, and Perplexity use these files to understand your site's structure and content.

Dynamic pages from data

You can now generate pages dynamically from data collections, perfect for catalogs, team pages, or any content driven by structured data files.

Developer experience

Dev mode got a lot of love in this release:

Custom error pages with source file location, detailed hints, and available alternatives when something goes wrong
Centralized filesystem watcher for reliable live reload
Simplified layout resolution with the new theme-layout key for explicit theme layout targeting

What's coming next in this series

Upcoming posts will dive deeper into:

The Roq CLI
LLMs.txt and AI discoverability
Dynamic pages from data
The new default theme and TailwindCSS integration

Ready to try it? Check out the Getting Started guide, or if you're already on Roq, see how to update.

Stay tuned and happy Roqing!