contentstack/gatsby-starter-contentstack

A starter kit for building a websites using Gatsby and Contentstack

Create a marketing website using Gatsby

About Contentstack: Contentstack is a headless CMS with an API-first approach that puts content at the centre. It is designed to simplify the process of publication by separating code from content.

About this project: Create professional marketing-themed website using Gatsby.

Live Demo

You can check the live demo to get first-hand experience of the website.

Prerequisites

• Install nodejs on your system.
• Install Gatsby CLI.

npm install -g gatsby-cli

Clone the repo

Clone the following repo. It contains all the required dependencies.

git clone https://github.com/contentstack/gatsby-starter-contentstack.git

Install dependencies

Go to the gatsby-starter-contentstack folder, and run the following:

• cd gatsby-starter-contentstack
• npm install

This downloads the required files and initializes the site.

Update Contentstack secrets

Copy the .env.sample file to .env.development and .env.production and update with your Contentstack details, including your API key and delivery token.

It should end up looking something like:

CONTENTSTACK_API_KEY='hunter2'
CONTENTSTACK_DELIVERY_TOKEN='hunter2token'
CONTENTSTACK_ENVIRONMENT='publishing environment'

Tutorial

We have created an in-depth tutorial on how you can create a website using Gatsby. By following the steps given in the tutorial, design a website similar to the one given in the demo.

Create a marketing website using Gatsby

More resources:

• Contentstack documentation
• Contentstack + Gatsby app tutorial

gatsby-starter-contentstack's Issues

Starter fails on install

Whether using git clone or gatsby new, the starter fails on npm install. It appears to get hung up on [email protected] install. Screenshot attached.

Gatsby info:

  System:
    OS: macOS 10.14.6
    CPU: (8) x64 Intel(R) Core(TM) i7-8569U CPU @ 2.80GHz
    Shell: 5.3 - /bin/zsh
  Binaries:
    Node: 12.14.1 - ~/.nvm/versions/node/v12.14.1/bin/node
    Yarn: 1.19.1 - /usr/local/bin/yarn
    npm: 6.13.4 - ~/.nvm/versions/node/v12.14.1/bin/npm
  Languages:
    Python: 2.7.10 - /usr/bin/python
  Browsers:
    Chrome: 80.0.3987.132
    Safari: 13.0.5
  npmPackages:
    gatsby: ^2.8.5 => 2.8.5
    gatsby-plugin-offline: ^2.0.5 => 2.0.5
    gatsby-plugin-react-helmet: ^3.0.0 => 3.0.0
    gatsby-source-contentstack: ^1.0.0 => 1.0.2
  npmGlobalPackages:
    gatsby-plugin-console-log-c: 1.0.0

gatsby-source-contentstack dependency is outdated and throwing an error

Hi,

currently the project is using "gatsby-source-contentstack" version 1.0.0
And I get this error.

TypeError: Cannot read property 'length' of undefined
  
  - asyncro.js:1 s
    [gatsby-starter-contentstack]/[asyncro]/dist/asyncro.js:1:846
  
  - asyncro.js:1 
    [gatsby-starter-contentstack]/[asyncro]/dist/asyncro.js:1:772

  - asyncro.js:1 
    [gatsby-starter-contentstack]/[asyncro]/dist/asyncro.js:1:818

  - new Promise

  - asyncro.js:1 i
    [gatsby-starter-contentstack]/[asyncro]/dist/asyncro.js:1:603

  - fetch.js:200 _callee7$
    [gatsby-starter-contentstack]/[gatsby-source-contentstack]/fetch.js:200:14

  - new Promise

  - fetch.js:242 fetchEntries
    [gatsby-starter-contentstack]/[gatsby-source-contentstack]/fetch.js:242:16

  - fetch.js:48 _callee$
    [gatsby-starter-contentstack]/[gatsby-source-contentstack]/fetch.js:48:14

After updating the dependency to the newest version "2.0.4" and changing "access_token" in "gatsby-config.js" to "delivery_token" it works as expected

Not showing up in Gatsby showcase

This starter should be showing up here, right?

https://www.gatsbyjs.org/starters?s=contentstack&v=2