Mutual Aid - Resilience App Theme

Prerequisites

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

Get started

Fork the repository

$ cd <sites-folder>
$ git clone <your-forked-repo>

Make sure you have Gatsby installed globally

$ npm i -g gatsby

Install your packages

$ npm install

Start the server

$ npm start

Read more about contributing and keeping your fork up to date on our CONTRIBUTING

GraphQL

http://localhost:8000/__graphql

Note: This theme uses Gatsby v2 and Netlify CMS

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 stories functionality built with Netlify CMS
Editabe Pages: Landing, About, Stories-Collection and Contact page with Netlify Form support
Create Stories posts from Netlify CMS
Tags: Separate page for posts under each tag
Basic directory organization
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

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 AboutUsPagePreview from './preview-templates/AboutUsPagePreview';
import StoriesPostPreview from './preview-templates/StoriesPostPreview';
import IndexPagePreview from './preview-templates/IndexPagePreview';

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

CMS.registerPreviewTemplate('index', IndexPagePreview);
CMS.registerPreviewTemplate('about-us', AboutUsPagePreview);
CMS.registerPreviewTemplate('stories', StoriesPostPreview);

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

yarn remove netlify-cms-media-library-cloudinary

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

gatsby-plugin-purgecss

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Daniel Huerta} 🤔 📆 📖 💬	_{Joshua Wu} 💻 👀 📖	_{Paul Mendoza} 🐛 💻 📖 🤔 🚧 💬 👀 🛡️	_{Miles Thompson} 🤔 💻 👀 💬 🐛 💼 🖋 📆	_Karen 🎨 🤔 📆 💬	_{Tuan Nguyen} 🐛 💻 📖 🤔 🚧 📆 💬 👀	_lauramei 🤔 🎨 👀
_{sarahjagrowski} 🎨 🤔	_Sarah 📖 🎨 🤔 💬	_{Marek Dano} 💻 📖 🐛	_Amy 🐛 💻 📖 🤔 🚧 💬 👀 🛡️	_{Jacob Garlick} 🐛 ⚠️ 📖	_{Chase Lee} 💻	_{Yoonah Bae} 🎨 🤔
_sd33m 🤔 💬 ️️️️♿️	_{Courtney Beadel} 🎨 📖 🤔 💬	_{Azmain Amin} 🐛 💻 📖 🤔 🚧 💬 👀 🛡️	_{Jessica Ellis} 💻