Projects
A project maps one Git repository to everything it runs in production.
A project is one Git repository plus everything Buildfyio runs for it: one or more apps, their deployments, domains, environment variables, and analytics. For a simple repo that means a single app; for a monorepo it means several apps living side by side in the same project, deployed and scaled independently.
Anatomy
| Piece | What it is |
|---|---|
| Primary app | The main app of the repository — the project itself. Serves <project>.buildfyio.com. |
| Apps (components) | Additional apps from the same repo: web services, background workers, static sites, cron jobs. Each gets <project>-<app>.buildfyio.com. |
| Deployments | Immutable releases. Each push or manual deploy creates one; rollback re-points production at any previous one. |
| Domains | Platform subdomains plus your custom domains, attachable per app. |
| Environment | Encrypted variables, scoped project-wide, per app, or per branch. |
Production branch
Every project has a production branch (default main). Pushes to it build and deploy automatically via the GitHub App. Other branches can be deployed manually from the dashboard.
Isolation
Projects are isolated from each other at the network level — one project's containers cannot reach another project's. Apps within one project share a network and can talk to each other directly, which is what you want for a web app and its API.
Root directory
Each app has a root directory — where its code lives inside the repo (. for the repo root, apps/web for a workspace member). You can edit it any time from the Apps list; the next deploy uses the new path. Workspace members are still installed from the repository root — see Monorepos.