ConfigHub Examples

This repo contains runnable examples for ConfigHub.

Start Here

• AI assistants: AGENTS.md
• AI assistants with more context: AI-README-FIRST.md

Safe First Checks

For a read-only first pass:

./scripts/verify.sh
cub context list --json
cub space list --json
cub target list --space "*" --json

If you are not logged in yet, run cub auth login before the cub commands.

Stable Paths

• promotion-demo-data: no-cluster demo data for learning ConfigHub's App-Deployment-Target model and promotion flow.
• gitops-import: canonical Argo CD GitOps import example and docs companion.
• custom-workers: worker extension examples, including bridge, function, and policy workers.
• global-app: classic multi-service app example.
• helm-platform-components: platform component example for Helm-managed infrastructure.
• vm-fleet: VM fleet operations example.

Recommended Starting Points

• If you want the quickest no-cluster path, start with promotion-demo-data.
• If you want GitOps import, start with gitops-import and the Official GitOps Import docs.
• If you want worker extensibility, start with custom-workers.
• If you want a classic multi-service example, use global-app.

Companion Material

cub-scout remains useful as companion material and as a source of comparison fixtures:

• cub-scout examples index
• Apptique microservice examples