How Cascade works
The mental model: trunk, the environment chain, the release boundary, and the rollback and hotfix off-ramps.
Cascade
Declarative trunk-based CI/CD for GitHub Actions.
Define what to build and where to deploy in one manifest. Cascade generates the GitHub Actions wiring, tracks deployment state, manages releases, and cascades promotions through your environments.
The manifest (.github/manifest.yaml) is the single source of truth. It holds the pipeline configuration and the live deployment state for every environment. You run cascade generate-workflow once. After that, the generated workflows own their execution.
Getting Started
Walk through a first manifest and the generated workflows.
Manifest Reference
Every field of the manifest documented in one place.
Callback Contract
The inputs and outputs your build, deploy, and publish workflows exchange with cascade.
Generated Workflows
The exact file set cascade emits, and how orchestrate, promote, hotfix, and rollback move artifacts through environments.
CLI Reference
The commands and flags cascade exposes.
Architecture
The design, and what cascade does and does not own.
Project
Section titled “Project”Cascade is open source under the Apache 2.0 license. The source, issue tracker, and releases live at github.com/stablekernel/cascade.