Skip to content

.stagefreight.yml Example Manifests

Example configurations for every project archetype. Each file is a standalone, copy-paste-ready .stagefreight.yml using the v1 schema with comments explaining who it's for, what it does, and why.

Features that are planned but not yet implemented are preserved as commented # ── Roadmap blocks at the bottom of each file.

Per-Repo Manifests (.stagefreight.yml)

# Example Who it's for
01 minimal Solo dev, hobby project — build + push, nothing else
02 personal-docker-app Solo dev shipping a containerized side project to Docker Hub + GHCR
03 patched-fork Anyone maintaining local patches on top of upstream — -patched tags
04 mirror Read-only mirror placeholder — declaration for future daemon support
05 multi-image Monolithic codebase producing app + worker + migrations from one Dockerfile
06 cross-platform-cli CLI binary — release notes now, artifact builds when the feature ships
07 multi-toolchain-build Multi-SDK project — release notes + security now, artifact builds later
08 full-lifecycle Business app — every implemented v1 feature turned on
09 internal-tool Private team tooling — single registry, all branches push
10 library-package npm/PyPI/Go library — release notes + security scanning, no Docker
11 static-site Documentation repo — release notes + security scanning, no Docker
12 homelab-fork Homelab user with a customized fork — build + push with -custom tags
13 compliance-strict Regulated industry — full lint + security, SBOM required, fail_on_critical
14 microservices-monorepo Multiple distinct services in one repo, each with own Dockerfile
15 headless-worker Queue consumer / bot / cron job — dual-target (public + private branch builds)
16 helm-chart Helm chart or IaC module — release notes + security scanning
17 game-server Modded game server — build + push to private registry on every push
18 mobile-hybrid-app Mobile/hybrid app — container build for API backend, mobile artifacts later
19 open-source-maintainer OSS project — Docker Hub + GHCR + Quay, README sync, SBOM
20 data-pipeline ETL / data pipeline — branch builds to private registry
21 ml-model ML model serving — GPU image with CUDA build args, dual registry
22 s6-overlay-linuxserver S6-overlay / LinuxServer.io style — real LSCR tag patterns, 3 channels
23 ansible-collection Ansible collection/role — release notes + security scanning

Daemon Configuration

# Example What it is
24 daemon-config stagefreight serve config — providers, org defaults, mirrors, alerts

Manifest Complexity Gradient (implemented v1 features only)

~3 lines   04-mirror                        ← placeholder declaration
~10 lines  01-minimal                       ← build + push, nothing else
~15 lines  06-cli, 07-multi-toolchain,      ← release + security, no builds
           10-library, 11-static, 16-helm,
           23-ansible
~30 lines  02-personal, 09-internal,        ← single build + a few targets
           12-homelab, 17-game, 18-mobile
~50 lines  03-fork, 15-worker, 20-data,     ← build + multi-target
           21-ml-model
~80 lines  05-multi-image, 14-monorepo      ← multi-build + multi-target
~100 lines 08-full, 13-compliance,          ← builds + targets + lint + security
           19-oss, 22-s6-overlay