Quarkus Forge Docs

Quarkus Forge gives you two ways to generate Quarkus projects well: an interactive terminal UI for local use, and a headless CLI for CI, scripts, and containers.

Start Here

Modes at a Glance

TUI (interactive) Headless (generate)

Best for

Local development, exploration

CI pipelines, scripting, containers

Jar

quarkus-forge.jar

quarkus-forge-headless.jar

Interaction

Keyboard-driven UI

Flags only, non-interactive

Extension browsing

Live fuzzy search + favorites

--extension / --preset flags

Forgefile

Export via post-gen menu

--from, --save-as, --lock

JVM flag needed

--enable-native-access=ALL-UNNAMED

none

Core Capabilities

  • Interactive TUI with fast extension search, fuzzy highlighting, and clear selected-extension badges.

  • Headless generate command for CI and scripts with the same generation model as the TUI.

  • Unified Forgefile format: shareable template + optional locked section for deterministic builds.

  • Safe archive extraction with ZIP safety checks built in.

  • Configurable theming, IDE handoff, and machine-local session persistence.

  • JBang catalog integration for zero-install runs.