Projects is currently in Beta · Send feedback.

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:<team>/<project>

View projects

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.

Add a new project

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.

Configure a project

Team members can configure Prebuilds, and set the workspace class used for project workspaces, in project settings.

Project Settings

Remove a project

You can remove a project using the “Remove project” action from a project card.

Was this helpful?