Bazel Rules for Quarkus

Bazel rules for building and running Quarkus applications. Supports quarkus_app (production Fast-Jar), dev mode with hot-reload, quarkus_test (@QuarkusTest execution), and quarkus_extension_runtime (building, using, and publishing custom Quarkus extensions — see Building Quarkus Extensions and examples/demo_extension).

Installation

See install instructions on the release page.

Add to your MODULE.bazel:

bazel_dep(name = "com_clementguillot_rules_quarkus", version = "<VERSION>")

Usage

load("@rules_quarkus//quarkus:defs.bzl", "quarkus_app", "quarkus_test")

quarkus_app(
    name = "app",
    version = "1.0.0-SNAPSHOT",
    deps = [":lib"],
)

quarkus_test(
    name = "test",
    deps = [":test_lib"],
)

bazel run //:app       # Production mode
bazel run //:app_dev   # Dev mode (hot-reload + Dev UI)
bazel test //:test     # @QuarkusTest

See the Getting Started guide for full setup instructions.

Supported Versions

• Quarkus: 3.27.4 (LTS) or 3.33.2 (LTS)
• Bazel: 7+, 8+, or 9+
• Java: 17+
• Mode: Bzlmod only (WORKSPACE not supported)

Important: You must use one of the exact supported versions listed above (3.27.4 or 3.33.2). Quarkus bytecode generated during augmentation is tightly coupled to the exact patch version — even within the same minor, runtime incompatibilities can occur.

Documentation

• Getting Started
• Building Quarkus Extensions
• Native Image
• Architecture
• Developer Guide
• Dev Mode
• Quarkifier

License

See LICENSE.