What is the Project Browser?

A Project is a way to group multiple Sites from the same Git Repository. The Projects Browser lists all your Projects, and each Project page contains tabs for browsing Sites, visualizing publishing, reviewing Pull Requests, exploring branches, and managing your Project's settings.

The Projects Browser#

The Projects Browser lists all the Projects in your Organization. You can access the Projects Browser by clicking the Projects link in the App Sidebar.

From the Projects Browser, you can:

• View all your Projects at a glance
• Sort and filter Projects by name, URL, or last synced date
• Click a Project Card to open the Project Sites Browser
• Create a new Project using the Create a Project button

The Project Sites Browser#

The Project Sites Browser is the main view for an individual Project. It shows all the Sites connected to your Project and provides access to the Publishing, Pull Requests, Branches, and Project Settings tabs.

For each Site, the Project Sites Browser shows:

• The Site name and branch name
• The domain or testing URL
• The build and sync status
• Which branch the Site publishes to (e.g., "publishes to main")

You can switch between card and list views, and use the Create a Site button to add a new Site to your Project.

The Project Settings tab#

The Project Settings tab allows you to manage your Project across several sections:

• Details — Update your Project Name, Display URL, Description, Related Links, and optional Project tabs.
• Repository — View or change the connected Git Provider and Repository, toggle Allow all branching, and set the Main Branch.
• Branch Defaults — Configure default settings for new branch Sites, including the publishing method, authentication, and permissions.
• Deploy Previews — Configure Pull Request comments and automatic Site creation for Pull Requests. For more information, please read our documentation on Deploy Previews.
• Danger — Delete your Project. This does not delete the Sites within it.

Optional Project tabs#

By default, new Projects show only the Sites and Project Settings tabs. There are also three optional Projects tabs, which your developer can enable from the Details section under Project Settings:

• Publishing — Shows a graph of how the Sites in your Project publish to each other.
• Pull Requests — Shows all open and draft Pull Requests in the Git Repository connected to your Project, alongside any Sites connected to each.
• Branches — Shows all branches in the Git Repository connected to your Project, grouped by status, alongside any Sites connected to each.

For more information, please read our documentation on what optional Project tabs are and turning on optional Project tabs.