Gatsby Cloud GitHub Application

The Gatsby Cloud GitHub application facilitates communication between Gatsby Cloud and GitHub. The app powers login authentication, git commit-based build triggers, and Starter template site creation.

Starter Templates

The Create a Site from a Template flow allows you to create a new site based on select starter templates. When using this flow, Gatsby Cloud will ask you to grant "All repositories" access. This is necessary because Github doesn't offer a way to scope access to a specific repository that hasn't already been created.

If you would prefer to not grant access to all repositories, then you can follow these steps to use a starter template:

1. Clone the template you wish to use and manually push it to your Github repository.
2. Add that repository to the list of repositories that the Gatsby Cloud application on Github has access to. See Permission Scope section for details.
3. Add the site to Gatsby Cloud using the Create a Site from a Repository guide.

Permission Scope

You can go to https://github.com/settings/installations and configure the Gatsby Cloud application. Under Repository Access, choose All repositories or Only select repositories.