NOTE: Identity update - Gatsby-netlifycms-starter-template
is now Silverlux
A fully-responsive Gatsby based web-app template which can be easily hosted on any platform. This web-app uses the Netlify CMS as its content management system.
It follows the JAMstack architecture by using Git as a single source of truth, and Netlify for continuous deployment, and CDN distribution. Surely you can use a different host. Netlify CMS and Netlify are two different products and not to be confused as one dependent on another. You are free to use both in combination and separately as well.
A detailed blog post on how you can use this template for your blog (for free obviously) can be found here
There are two ways you can use this template
-
First Approach(Recommended) Use the button below and it'll automatically take you to the netlify and ask you to create a repository on your behalf in Github/Gitlab/Bitbucket as per you select. This is the recommended approach as it automatically takes care of all the process steps. You don't need to do anything else.
-
Second Approach Do it manually. It requires you to clone/fork this repository in your Github account, and setup the development environment in your system, install all the dependencies and then setup netlify account to pull the github published code for deployment. This approach is for advanced users as it allows users to edit the code and tweak the code as per preferences and it requires knowledge of code, development environment, deployment etc.
- A simple blogging web-app built with Netlify CMS
- Editable Pages: About, Blog-Collection and Contact page with Netlify Form support
- Custom 404 page
- Tags support: Separate page for posts under each tag
- Scroll to Top button on every page
- Create Blog posts from Netlify CMS
- 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
- Perfect score on Lighthouse for SEO, Accessibility and Performance
- Comment and Like functionality
- Cookie Consent
- Full text Search functionality powered by Fuse.js
For ease of access, the comment functionality provided by Disqus, has been added.
However, slight configure is required to make it fully functional.
- Register your website on the disqus platform, you'll get a shortname
- Update the shortname assigned to the Environment variable
DISQUS_SHORTNAME
here. Save it - If deploying on services like Heroku (free tier is over, it is paid now, but you're rich ? :p), make sure to add this environment variable to the service as well.
A detailed blog post on how to configure the Disqus plugin can be found here
For local development, you need
- Node (v8.2.0 or higher)
- Gatsby CLI
- Netlify CLI
To run or test the changes locally, simply follow these steps.
-
Use the right version of node, if you use nvm
nvm use 14.20
If you don't use nvm to manage the Node version in use, oh boy,..phew!
-
Install all the dependencies using
yarn install
-
After installing the dependencies, simply start for development mode
yarn start
-
You can also create a production build for manual deployment using
yarn build
Note: You can use Netlify CMS locally, just open another terminal and run the following command
npx netlify-cms-proxy-server
and start run gatsby develop
.
Follow the Netlify CMS Quick Start Guide to set up authentication, and hosting. You would need to enable Identity in the Netlify account if you are using Netlify for website deployment.
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
MacOS users might also encounter some errors, for more info check node-gyp. We recommend using the latest stable node version.
This plugin uses gatsby-plugin-purgecss and bulma. The bulma builds which usually generate a ~170Kb of .css file are reduced 90% by purgecss resulting in a .css file which at max is 16-18Kb.
Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct.
Disclaimer: Screenshots are old. I'm too lazy to take fresh screenshots again.
Update: The blog post now also features comment section and Cookie Consent.
- Dark Theme
This repository has MIT license which can be found here.