Back to docs

Getting started

Understanding projects

3 min read

A project is one deployable app, tied to one GitHub repo and branch.

What a project contains

Each project tracks its connected repo/branch, root directory (for monorepos), build and start commands, environment variables, and its history of deployments.

Project settings vs. project creation

Note: the new-project flow currently only exposes the root directory field, behind a collapsed "monorepo?" toggle. Build command and start command can be set after creation, from the project's Settings tab, which also has live repo-folder browsing the creation flow doesn't.

Deployments

Every push (or manual redeploy) creates a new deployment under the project. Old deployments stay visible so you can roll back to any of them.

Didn't find what you needed? Email support