Menu
How to build and test Quarkus: Maven commands, build flags, incremental builds, justfile aliases, and important build rules.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | building-and-testing |
| description | How to build and test Quarkus: Maven commands, build flags, incremental builds, justfile aliases, and important build rules. |
Quarkus uses Maven. The full build is large; know how to build selectively.
Ensure MAVEN_OPTS includes at least -Xmx4g for builds (do not override the user's existing MAVEN_OPTS).
./mvnw -Dquickly
This skips tests, ITs, docs, native, and validation.
# All modules of an extension
./mvnw install -f extensions/<name>/
# A single module
./mvnw install -f extensions/<name>/deployment
./mvnw install -f core/ -DskipTests
# Run tests for an extension
./mvnw verify -f extensions/<name>/ -Dstart-containers -Dtest-containers
# Run a single test class
./mvnw test -f integration-tests/<name>/ -Dstart-containers -Dtest-containers -Dtest=MyTest
# Run a single test method
./mvnw verify -Dstart-containers -Dtest-containers -Dtest=fully.qualified.ClassName#methodName
# Native integration tests
./mvnw verify -f integration-tests/<name>/ -Dstart-containers -Dtest-containers -Dnative
# Build only changed modules and their downstream dependencies
./mvnw install -Dincremental
| Flag | Purpose |
|---|---|
-Dquickly | Skip tests, ITs, docs, native, validation |
-DquicklyDocs | Like -Dquickly but includes docs |
-Dnative | Build and test native image |
-Dno-format | Skip code formatting check |
-DskipTests / -DskipITs | Skip unit / integration tests |
-Dno-test-modules | Skip building test modules |
-Dincremental | Only build changed modules |
A justfile (.justfile in the repo root) provides convenience aliases. Run just -l to
see them. By default uses ./mvnw -T0.8C (parallel build). Set QMVNCMD
to override the Maven command (e.g., QMVNCMD=mvnd for Maven Daemon).
install (not just compile) when building modules that other modules depend oncore/, downstream extensions may need rebuilding./mvnw (the wrapper) to ensure the correct Maven versionupdate-extension-dependencies.shHow to build, preview, and verify Quarkus documentation locally: root Maven build, docs rebuild, Jekyll preview via Podman/Docker.
Quarkus code style conventions: formatting, visibility, naming, logging, and general style rules for the Quarkus codebase.
Testing patterns for Quarkus extensions: test annotations, test locations, QuarkusExtensionTest patterns, and how to run tests.
How to add a Dev UI page to a Quarkus extension: deployment processors, runtime-dev JSON-RPC services, and Lit web components.
Rules for preparing pull requests and commits in the Quarkus project: title conventions, description format, commit hygiene, labels, and contribution policies.
Quarkus split classloading model, runtime-dev module wiring, conditional dependencies, and common classloading mistakes.