Branches

← Back to standards

Idea (developing)

The branch name is the file name. If you know the Git branch, you know which Fly config and which deploy workflow apply—no special “production” filenames.

Topics we will cover

Git branch	Fly config	GitHub workflow
staging	fly.staging.toml	fly-deploy-staging.yml
main	fly.main.toml	fly-deploy-main.yml
uat (future)	fly.uat.toml	fly-deploy-uat.yml

• Never use: fly.production.toml, fly.prod.toml, fly.stag.toml, deploy-production.yml, deploy-prod.yml
• main deploys to the production Fly org but the config file stays fly.main.toml
• Workflows trigger on push to the matching branch and pass --config fly.<branch>.toml
• Main-only repos: only fly.main.toml and fly-deploy-main.yml (no placeholder staging files)

Content coming soon.