Projects live under a Gitpod team. They connect Gitpod to a git repository. A Gitpod project can only have one git repository, and a git repository can only belong to one project.
A project is required in order to trigger prebuilds on a repository. Team members use the project to configure and view prebuilds.
With pay-as-you-go billing, all project usage such as workspaces and prebuilds, may be billed to the team.
Projects have a static URL based on the team and project name, for example:
The Projects page for a team shows a card for each project.
Cards show the name, repository URL, quick links to project branches and prebuilds, and the branch and timestamp of the latest prebuild.
To add a new project, click on New Project on the Projects page for the team, and select a repository from the list.
The list will show repositories from one of your git providers. Select a different provider if necessary. You may also be prompted to configure our GitHub app, the first time a project is created for a GitHub account. The new project will be associated with the current team selected in the dashboard.
Team members can configure Prebuilds, and set the workspace class used for project workspaces, in project settings.
You can remove a project using the “Remove project” action from a project card.