ConfigHub Examples

This repo contains examples that demonstrate how ConfigHub works in multiple scenarios.

Start Here

• For humans: START_HERE.md
• For AI assistants (short protocol): AGENTS.md
• For AI assistants: AI-README-FIRST.md

Examples Catalog

• global-app: classic multi-service app example.
• custom-workers: worker extension examples using the ConfigHub SDK as normal Go modules.
• helm-platform-components: platform component setup.
• vm-fleet: VM fleet operations example.
• incubator: experimental examples, including the current Argo and Flux import paths plus the recipes-and-layers work.

Current Wedge

For the current GitHub + Argo/Flux + AI/CLI + ConfigHub wedge, start here:

• Official GitOps Import docs
• incubator/gitops-import-argo
• incubator/gitops-import-flux
• custom-workers

These are the runnable examples for import, evidence, and worker extensibility in this repo today.

Companion Material

cub-scout remains useful as companion material and as a source of example fixtures, especially for deeper app-style comparisons:

• cub-scout examples index
• Apptique microservice app styles

Prerequisites

cub auth login

Run Checks

./scripts/verify.sh

General Script Behavior

Scripts are designed to be additive and explicit. Read scripts before running them in shared environments.