Gatsby Cloud Docs

Autoprovisioning a New Site

Create a new Gatsby Cloud site using Cloud's autoprovisioning flow

Table of Contents

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 include Contentful, Cosmic, and DatoCMS.

Create a new site

In your Cloud dashboard, click ”Create New Site”. Then, select “I don’t have a Gatsby site yet”.

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:

  1. The corresponding new project in your CMS provider.
  2. 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:

  1. 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.

  2. 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.

  3. 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.

  4. If you want to look at your changes, run gatsby develop in your CLI and navigate to localhost:8000 in your browser.

  5. 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.

© 2020 Gatsby, Inc.