Why keep infrastructure in your repository
Settings that live only in a dashboard are hard to review, hard to copy, and easy to lose. With your stack in a config file, every change goes through the same pull request process as your code, and a new environment is one command away.
What the file can describe
The config covers everything the platform runs for you. Anything you can set in the dashboard has a matching field in the file.
- Web services, private services, workers, and cron jobs
- Managed Postgres and in-memory caches
- Variable sets, domains, and scaling rules
Working with the dashboard
You can still make quick changes in the dashboard. When the live stack drifts from the file, you see a warning and can either update the file or let the next sync reset the change.