Files
james.maes 92f2ec557b feat(release): migrate extension template to QQQ 4.0 (#4)
* fix(template): prepare extension scaffold for QQQ 4.0

* fix(ci): avoid interactive package restart prompts

* docs: align guides and examples with QQQ 4.0

* docs(release): finalize QQQ 4.0 template instructions

Refs QRun-IO/qqq#631.
2026-09-24 13:32:16 -05:00

1.3 KiB

QBit Template: Extension

Template repository for creating QQQ Extension QBits - infrastructure extensions, customizers, and action handlers.

What is an Extension QBit?

Extension QBits extend or enhance how QQQ operates at the infrastructure/framework level. They provide:

  • New backend implementations
  • Authentication mechanisms
  • Audit capabilities
  • Table customizers
  • Action handlers

Quick Start

Requires Java 21, Maven 3.8+, and QQQ 4.0.0. Create your repository, customize its Maven coordinates and Java package/classes, implement the table customizer, then run mvn clean verify. See Getting Started.

Structure

src/main/java/com/kingsrook/qbits/example/
├── ExampleExtensionQBitConfig.java    # Configuration
├── ExampleExtensionQBitProducer.java  # Entry point
└── customizers/
    └── ExampleTableCustomizer.java    # Table customization

Key Characteristics

  • No QAppSection - Pure infrastructure
  • No user-facing tables (or minimal operational)
  • Wraps existing tables/processes with new behavior
  • Validates dependencies on other QQQ components

Documentation

License

See LICENSE and NOTICE.