Gatsby Cloud’s autoprovisioning workflow will set up a new site for you using a preconfigured starter. You don’t need to have an existing project repo or content manager set up yet — Gatsby Cloud will guide you through it, and do much of it automatically.
Current CMS providers supported in the autoprovisioning flow can be found here.
Create a new site
Choose a preconfigured starter
Select an available starter you want to use, and click “Next”.
Set up a GitHub repo and your CMS provider
Choose a name for the new GitHub repo that will be associated with your new project, and click “Next”.
Gatsby Cloud will then prompt you to connect to the CMS provider used in the starter you chose. For example, if the starter you chose uses Contentful, Gatsby Cloud will guide you through the process of connecting to Contentful.
- Note: Depending on which CMS you’re connecting to, this process may look slightly different, as each CMS provider is different.
Once you’ve successfully authorized with whichever CMS provider you’ve chosen, Gatsby Cloud will show you a summary for your new site, including external links to:
- The corresponding new project in your CMS provider.
- The corresponding new repo in GitHub.
Editing your site code
While you can edit content in your chosen CMS, you may find yourself wanting to edit the code portion of your site as well. In order to do so, follow these steps:
Navigate to your project repo in GitHub. You can find the repository link in “Site Settings” under the “Site details” section at the top of the page.
Pull down a local copy of this project using the
git clone <project_url>command in your command line interface (CLI). If you’re not familiar with the GitHub UI take a look at the documentation.
You can now edit the code for your starter project using whichever code editor you prefer. Take a look at the documentation for modifying a starter.
If you want to look at your changes, run
gatsby developin your CLI and navigate to
localhost:8000in your browser.
Once you’re happy with the changes to your site, commit and push the updates to GitHub, which will automatically trigger a new build of your site on Gatsby Cloud.
Note that if you need to change any information about your site’s connection to your CMS you’ll need to edit your environment variables.