kunalpanchal / chocobeats-gatsby

Gatsby + Netlify CMS Starter

Note: This starter uses Gatsby v2.

This repo contains an example business website that is built with Gatsby, and Netlify CMS: Demo Link.

It follows the JAMstack architecture by using Git as a single source of truth, and Netlify for continuous deployment, and CDN distribution.

Features

• A simple landing page with blog functionality built with Netlify CMS
• Editable Pages: Landing, About, Product, Blog-Collection and Contact page with Netlify Form support
• Create Blog posts from Netlify CMS
• Tags: Separate page for posts under each tag
• Basic directory organization
• Uses Bulma for styling, but size is reduced by purge-css-plugin
• Blazing fast loading times thanks to pre-rendered HTML and automatic chunk loading of JS files
• Uses gatsby-image with Netlify-CMS preview support
• Separate components for everything
• Netlify deploy configuration
• Netlify function support, see lambda folder
• Perfect score on Lighthouse for SEO, Accessibility and Performance (wip:PWA)
• ..and more

Prerequisites

• Node (I recommend using v8.2.0 or higher)
• Gatsby CLI
• Netlify CLI

Getting Started (Recommended)

Netlify CMS can run in any frontend web environment, but the quickest way to try it out is by running it on a pre-configured starter site with Netlify. The example here is the Kaldi coffee company template (adapted from One Click Hugo CMS). Use the button below to build and deploy your own copy of the repository:

After clicking that button, you’ll authenticate with GitHub and choose a repository name. Netlify will then automatically create a repository in your GitHub account with a copy of the files from the template. Next, it will build and deploy the new site on Netlify, bringing you to the site dashboard when the build is complete. Next, you’ll need to set up Netlify’s Identity service to authorize users to log in to the CMS.

Access Locally

Pulldown a local copy of the Github repository Netlify created for you, with the name you specified in the previous step

$ git clone https://github.com/[GITHUB_USERNAME]/[REPO_NAME].git
$ cd [REPO_NAME]
$ yarn
$ netlify dev # or ntl dev

This uses the new Netlify Dev CLI feature to serve any functions you have in the lambda folder.

To test the CMS locally, you'll need to run a production build of the site:

$ npm run build
$ netlify dev # or ntl dev

Media Libraries (installed, but optional)

Media Libraries have been included in this starter as a default. If you are not planning to use Uploadcare or Cloudinary in your project, you can remove them from module import and registration in src/cms/cms.js. Here is an example of the lines to comment or remove them your project.

import CMS from 'netlify-cms-app'
// import uploadcare from 'netlify-cms-media-library-uploadcare'
// import cloudinary from 'netlify-cms-media-library-cloudinary'

import AboutPagePreview from './preview-templates/AboutPagePreview'
import BlogPostPreview from './preview-templates/BlogPostPreview'
import ProductPagePreview from './preview-templates/ProductPagePreview'
import IndexPagePreview from './preview-templates/IndexPagePreview'

// CMS.registerMediaLibrary(uploadcare);
// CMS.registerMediaLibrary(cloudinary);

CMS.registerPreviewTemplate('index', IndexPagePreview)
CMS.registerPreviewTemplate('about', AboutPagePreview)
CMS.registerPreviewTemplate('products', ProductPagePreview)
CMS.registerPreviewTemplate('blog', BlogPostPreview)

Note: Don't forget to also remove them from package.json and yarn.lock / package-lock.json using yarn or npm. During the build netlify-cms-app will bundle the media libraries as well, having them removed will save you build time. Example:

yarn remove netlify-cms-media-library-uploadcare

OR

yarn remove netlify-cms-media-library-cloudinary

Getting Started (Without Netlify)

$ gatsby new [SITE_DIRECTORY_NAME] https://github.com/netlify-templates/gatsby-starter-netlify-cms/
$ cd [SITE_DIRECTORY_NAME]
$ npm run build
$ npm run serve

Setting up the CMS

Follow the Netlify CMS Quick Start Guide to set up authentication, and hosting.

Debugging

Windows users might encounter node-gyp errors when trying to npm install. To resolve, make sure that you have both Python 2.7 and the Visual C++ build environment installed.

npm config set python python2.7
npm install --global --production windows-build-tools

Full details here

MacOS users might also encounter some errors, for more info check node-gyp. We recommend using the latest stable node version.

Purgecss

This plugin uses gatsby-plugin-purgecss and bulma. The bulma builds are usually ~170K but reduced 90% by purgecss.

CONTRIBUTING

Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct.

chocobeats-gatsby's Issues

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Rate-Limited

These updates are currently rate-limited. Click on a checkbox below to force their creation now.

• fix(deps): update dependency bulma to v1
• fix(deps): update dependency gatsby-plugin-netlify to v5
• fix(deps): update dependency gatsby-plugin-purgecss to v6
• fix(deps): update dependency gatsby-remark-relative-images to v2
• fix(deps): update dependency node-sass to v9
• fix(deps): update dependency uuid to v9
• fix(deps): update gatsby monorepo (major) (gatsby, gatsby-image, gatsby-plugin-netlify-cms, gatsby-plugin-react-helmet, gatsby-plugin-sass, gatsby-plugin-sharp, gatsby-remark-copy-linked-files, gatsby-remark-images, gatsby-source-filesystem, gatsby-transformer-remark, gatsby-transformer-sharp)
• fix(deps): update react monorepo to v18 (major) (react, react-dom)
• 🔐 Create all rate-limited PRs at once 🔐

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• fix(deps): update dependency bulma to v0.9.4
• fix(deps): update dependency netlify-cms-media-library-cloudinary to ^1.3.10
• fix(deps): update dependency netlify-cms-media-library-uploadcare to ^0.5.10
• fix(deps): update lodash monorepo (lodash, lodash-webpack-plugin)
• chore(deps): update dependency prettier to v2.8.8
• fix(deps): update dependency gatsby-plugin-netlify to v2.11.1
• fix(deps): update dependency netlify-cms-app to ^2.15.72
• fix(deps): update dependency prop-types to v15.8.1
• fix(deps): update gatsby monorepo (gatsby, gatsby-image, gatsby-plugin-netlify-cms, gatsby-plugin-react-helmet, gatsby-plugin-sass, gatsby-plugin-sharp, gatsby-remark-copy-linked-files, gatsby-remark-images, gatsby-source-filesystem, gatsby-transformer-remark, gatsby-transformer-sharp)
• chore(deps): update dependency prettier to v3
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

npm

package.json

• bulma ^0.9.0
• gatsby ^2.20.35
• gatsby-image ^2.3.5
• gatsby-plugin-netlify ^2.2.4
• gatsby-plugin-netlify-cms ^4.2.5
• gatsby-plugin-purgecss ^5.0.0
• gatsby-plugin-react-helmet ^3.2.5
• gatsby-plugin-sass ^2.2.4
• gatsby-plugin-sharp ^2.5.7
• gatsby-remark-copy-linked-files ^2.2.4
• gatsby-remark-images ^3.2.6
• gatsby-remark-relative-images ^0.3.0
• gatsby-source-filesystem ^2.2.5
• gatsby-transformer-remark ^2.7.5
• gatsby-transformer-sharp ^2.4.7
• lodash ^4.17.15
• lodash-webpack-plugin ^0.11.4
• netlify-cms-app ^2.9.6
• netlify-cms-media-library-cloudinary ^1.3.2
• netlify-cms-media-library-uploadcare ^0.5.2
• node-sass ^4.14.0
• prop-types ^15.6.0
• react ^16.8.4
• react-dom ^16.8.4
• react-helmet ^6.0.0
• uuid ^7.0.0
• prettier ^2.0.5

---

• Check this box to trigger a request for Renovate to run again on this repository