Browse documentation

Creating qBits

Create an application, data, or extension QBit using the 4.0 templates.

Choose a template

TemplatePurpose
ApplicationTables, processes, navigation, and widgets
DataReference data and sync scaffolding
ExtensionFramework customizers and infrastructure behavior

Use the repository template feature, then rename Maven coordinates, Java packages, classes, and metadata names. Follow its getting-started guide and run mvn clean verify on the generated project. These are scaffolds; supply business rules, integration credentials, tests, and host configuration.

Register in the host

QBits use a producer and a component-specific config. The data template demonstrates withConfig followed by produce(qInstance, "example-data"). The host must define the backend before production and validate the assembled QInstance. Prefixing tables alone is insufficient for multiple instances: process names, possible-value sources, and references must also be unique.

Versions and publication

Choose a real released dependency version and verify its compatibility with your host. The 4.0 build-parent target is com.kingsrook:qbit-build-parent:2.0.0, published after final core. Check release status before using it. Existing production QBits are outside this release train's certification.

Publish your own component through its configured Maven release process. The template example artifacts are not published components, and no qbits-registry registration is required by the framework. Preserve each component's LICENSE and NOTICE.

Powered by qqq