Repository files navigation

This repository is the backing catalog for theQuarkus community extension registry.Extensions added here will be included in registry.quarkus.io.

A catalog is a local directory (which can be cloned from a Git repository) with the following structure:

.├── extensions│   └──<any_extension>.yaml└── platforms│   └──<any_platform>.yaml

For maintenance purposes, each extension is declared in its own file and has the following structure:

group-id:org.apache.myfaces.core.extensions.quarkusartifact-id:myfaces-quarkus

The Quarkus extension MUST be released to a Maven repository. The descriptor states the Maven coordinates and the repository URL (if available).

IMPORTANT: The extension must be released using at least Quarkus 1.13.0.Final, otherwise the produced metadata won't be understood by the Registry application

Having an extension built against Quarkus Core version X.Y, it is assumed that the extension release is compatible with any requested Quarkus version >= X.Y and less than (X+1).0. That is, minor Quarkus releases are assumed to be backwards compatible for extensions, but major ones are not.If you want to mark an extension release compatible with an older Quarkus core version, or across major version boundaries, add acompatible-with-quarkus-core attribute inside the version, as in the following example:

group-id:"io.quarkiverse.arthas"artifact-id:"quarkus-arthas"versions:  -"0.1":compatible-with-quarkus-core:        -"2.8.3.Final"

Platforms are a set of extensions and MUST exist as a BOM.

group-id:"io.quarkus"artifact-id:"quarkus-bom-quarkus-platform-descriptor"classifier-as-version:true

As well as the catalog information, this repository also holds information about which organizations and companies have opted-in to be shown in the Quarkiverse tooling.The opt-in information is in thenamed-contributing-orgs-opt-in.yml file.If a company has made a sustained contribution to an extension, the Quarkiverse tooling will auto-detect it as a sponsor. It won't identify a company as a sponsor without an opt-in.To opt-in, add your company's name to thenamed-sponsors list.If you would like your company to be shown on things like contributor graphs, butnot ever listed as a sponsor, update thenamed-contributing-orgs list.There is no need to updatenamed-contributing-orgs if your company is listed innamed-sponsors.

Sponsorship can also be indicated manually, by updating an extension'sextension metadata.