Projects

What is a project

A project groups related services so they can share environments, variables, and permissions. Most teams create one project per product or client.

What belongs in a project

• App services that ship the user facing product.
• Worker services for background jobs and scheduled tasks.
• Database services for persistent data.
• Shared environment variables and secrets.

Project structure tips

• Use one project per product to keep deployments organized.
• Separate staging and production with environments instead of new projects.
• Name services clearly so logs and metrics are easy to scan.