Gatsby

Generate static sites with Cloud CMS

gatsbyjs.png

Building a static site with Cloud CMS content is simple with Gatsby JS. Below you will find tools and examples for how to get started.

Connecting to Cloud CMS with Gatsby

You can connect directly to the Cloud CMS API or indirectly via our app server. We offer GraphQL endpoints on each of these that can be accessed using our gatsby-source-cloudcms plugin.

In your gatsby-config.js file, add the following configurations:

const gitanaJson = require('./gitana.json');

module.exports =
{
    plugins: [
        {
            resolve: `gatsby-source-cloudcms`,
            options: {
                keys: gitanaJson,
                repositoryId: `repositoryId`,
                branchId: `branchId`
            }
        }
    ]
}

API Keys

Every mobile app or web site that you build will need to have a set of API Keys that it will use to connect to your Cloud CMS platform on behalf of your code. These API keys consist of client and user key/secret pairs.

  1. Log in to your Cloud CMS tenant at https://<yourdomain>.cloudcms.net
  2. From Manage Platform -> API Keys

You will now see your API Keys for all of your platform's Application instances.

You can create as many Application instances as you'd like and each will have their own set of API Keys.

Download the gitana.json file, as you will need this to provide authentication for the example applications.

For more information, visit Configuring your API Keys.

Bookstore Example Site

The example site is a simple bookstore website, built using the Cloud CMS Sample Project and using Nuxt.js as a generator. It is intended for Nuxt developers to get a general sense of how Cloud CMS content might be used in their application, but is not intended for production use.

To setup the sample project:

  1. Log in to your Cloud CMS tenant at https://<yourdomain>.cloudcms.net
  2. Create a project, and select Sample Project as the project type
example-site.png

Source Code and Setup

The code for this example is available as part of the Gitana SDK, which contains usages of Cloud CMS with many different languages and frameworks.

  1. To download, run git clone https://github.com/gitana/sdk.git
  2. Navigate to the gatsbyjs/sample directory
  3. Follow the instructions in README.md