Quarkus Forge Docs

Quarkus Forge is a keyboard-first terminal UI and headless CLI to generate Quarkus projects quickly — an offline-capable, CI-ready alternative to quarkus create.

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

  • Guided TUI with fast extension search, fuzzy highlighting, and chip-style selection badges.

  • Extension descriptions shown inline from the Quarkus API.

  • Headless generate command for CI and scripts; identical output to TUI.

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

  • Safe archive extraction with Zip-Bomb and Zip-Slip protection.

  • Configurable theming and IDE command for terminal readability.

  • Session persistence — remembers your last selections across launches.

  • JBang catalog integration for zero-install runs.