This topic describes the core concept of branches in Grafbase and their association with a GitHub branch.

As described in the Projects topic, projects are associated with a single GitHub repository. Since most repositories have multiple branches, you can add one or more of the repository branches to the project as project branches. Regardless of the number of branches, only one branch represents the production environment of the project. We call that branch the production branch. All other branches are preview branches.

Branches have deployments, and each deployment belongs to a single branch. Branches can have a history of deployments, with at-most one active deployment. See the Deployments topic for futher information about deployments.