quarkusio/quarkus

building-docs

How to build, preview, and verify Quarkus documentation locally: root Maven build, docs rebuild, Jekyll preview via Podman/Docker.

coding-style

Quarkus code style conventions: formatting, visibility, naming, logging, and general style rules for the Quarkus codebase.

writing-tests

Testing patterns for Quarkus extensions: test annotations, test locations, QuarkusExtensionTest patterns, and how to run tests.

writing-extension-devui

How to add a Dev UI page to a Quarkus extension: deployment processors, runtime-dev JSON-RPC services, and Lit web components.

building-and-testing

How to build and test Quarkus: Maven commands, build flags, incremental builds, justfile aliases, and important build rules.

pull-requests

Rules for preparing pull requests and commits in the Quarkus project: title conventions, description format, commit hygiene, labels, and contribution policies.

classloading-and-runtime-dev

Quarkus split classloading model, runtime-dev module wiring, conditional dependencies, and common classloading mistakes.

creating-extensions

How to create a new Quarkus extension: full module layout, package naming, artifact naming, dependency rules, and Dev UI setup.

working-with-config

Quarkus configuration conventions: @ConfigMapping interfaces, config phases, and migration from legacy @ConfigRoot classes.

writing-build-steps

Patterns for creating and modifying Quarkus @BuildStep methods, build items, and recorders in extension deployment modules.