Skip to content

Quick Start Scenarios

The fastest way to learn StageFreight is to read a real .stagefreight.yml that's actually running. Below are live configs across different project archetypes — open the one closest to yours, copy the shape, then reach for Configuration when you want a knob it doesn't show.

This is the happy path

These configs are deliberately representative, not exhaustive. If you want a capability you don't see here, check Configuration to see whether the knob exists yet and what it accepts.

Pick the scenario closest to yours

Scenario Archetype Knobs it demonstrates Live config
Container app (full lifecycle) Dockerfile image, dev + stable channels builds, kind: registry, kind: docker-readme, narrate badges, retention DD-UI
CLI / binary distribution Go binary + image + downloadable archives kind: binary, kind: binary-archive, kind: release with checksums HASteward · Dragonfly · Jetpack
GitOps repo Flux manifest validation, no image build lifecycle: { mode: gitops }, cluster auth Dungeon
Governance / control repo Policy reconciliation across repos lifecycle: { mode: governance } MaintenancePolicy
Dogfood: everything at once StageFreight building itself every target kind, kind: command docs build, self-hosted release channels StageFreight

More scenarios coming

A couple of archetypes aren't public yet and will be added as those repos open up: static site → Cloudflare Pages (kind: pages) and Ansible collection (kind: gitlab-component). Until then, Configuration › Targets documents both.