Gatsby Book Launch

“The missing guide to the modern web” launches on Thursday, Sep 29th: Modular: The Web’s New Architecture

Create a Site from a Template

Introduction

This guide covers how to create a Gatsby Cloud site by cloning a Gatsby starter. Note, cloning of starters is only supported for Github. If you use GitLab or BitBucket, you’ll have to follow the Create a Site from a Repository guide instead.

Directions

1. Choose your starter template

From your Gatsby Cloud dashboard, click “Add a Site”.

Button to add a site from the Gatsby Cloud dashboard

On the right hand side, click on the card labeled “Gatsby Default Starter”.

Clone Gatsby Default Starter

2. Configure your repository

The first time you set up a Gatsby Cloud site, you will need to connect your Gatsby account to Github by clicking on the “Github” icon in the “Create a Git repository” card.

Create a Git Repository

Next, a pop up window should appear and prompt you to install the Gatsby Cloud app to your Github personal account. Click “Install”.

Gatsby Cloud app permissions

After the Github app is installed, you will return to Gatsby Cloud. Here you can select a different Github organization to host the repository under as well as change the name of the repository that will be created if you prefer. Then click “Next” to create the site.

Configure Git repository settings

3. Connect integrations

Next, you’ll be prompted to connect any integrations. Here is where you can connect your Gatsby Cloud site to your CMS instance. For the purposes of this tutorial, you can select “Skip this step”.

List of available integrations

4. Set-up summary

After the repository is created, you’ll be given the option to configure any necessary environment variables. This step allows you to add both build and preview variables to your site.

Section to add environment variables

Next, click “Create Site” and you will be taken to the main tab of the Site Overview page for your new site.

Site Overview screen

5. Finish

Once your site is done building, you can view the site in two places:

Private build URL

Use the build URL to preview the deployed site. This URL is not indexed and is only accessible via direct link.

Private Build URL Link

Public default domain

Use your Gatsby Hosting provided “default domain” to access the public deployment of your site. Gatsby Hosting is turned on by default and the “default domain” is listed under “Site Settings > Hosting”.

Default Domain URL link

Edit this page on GitHub
© 2022 Gatsby, Inc.