Yellowcake
An opinionated starter project for creating lightning-fast websites with Gatsby v2 and Netlify CMS v2. Made by Thrive Web Design on the Gold Coast, Australia
- Gatsby static site generator
- Netlify CMS for content management
See also
Netlify CMS Docs
Netlify CMS Repo
Get going
- Hit the Deploy to Netlify button. This will:
- Clone the repo into your Github account
- Create you a new project on Netlify, build & deploy
- Once your Netlify project has been created, check a couple of settings:
- Enable Identity
- Change Registration Preferences to Invite Only
- Enable Git Gateway
- Invite users (probably yourself) to enable admin access
- Open the Identity tab and hit Invite Users
Show me the CMS!
The CMS lives at __YOUR_SITE_NAME__.netlify.com/admin.
Developing
-
Clone your repo to your local machine
-
Install dependencies
yarn
or npm install
- Run the development server
yarn start
or npm run start
If you are adding or editing content locally in the CMS, a couple of things to note:
-
Changes will be pushed to the remote repo.
-
You will be prompted to enter your site's url, this is necessary for Netlify Identity to manage user login. This is stored in
localStorage
, so you might have to empty your browser cache if you are switching projects but remaining onlocalhost:8000
.
Editing CMS fields
The Netlify CMS configuration is located in public/admin/config.yml
. This is where you will configure the pages, fields, posts and settings that are editable by the CMS.
Find out more in the Netlify CMS Docs.
Uploadcare setup
Uploadcare is our file upload system. It hosts the files for us and delivers them trough their CDN network. Each site you'll create need its own Uploadcare API key's. See below how to set this up
- Create new project in Uploadcare and save API keys in project
- Go to Uploadcare.com and login
- Once on the dashboard create a new project
- Set the name and hit create
- In the left menu click in API Keys and copy the public key
- Create an environment variable GATSBY_UPLOADCARE_PUBLIC_KEY and supply it with the Public Key from Uploadcare
- Done!!
For more details see the Netlify CMS Docs
Scheduled content
Scheduled content allows you to schedule posts. Set the date / order field in a post to the feature. For the scheduled content to appear on the website we need to deploy our website daily.
- Setup a Netlify build hook
- Go to https://app.netlify.com/sites/_YOUR_SITE_NAME/setings/deploys/#build-hooks
- Hit build hook button in the build hooks section
- Give it a name for example: "Automatic deploy Zapier"
- Select branch, in most cases master will do.
- Hit save and copy the generated url
- Zapier Setup
- Go to Zapier.com and login
- Hit make a zap button in the right top corner
- Search for Schedule in the search bar and select "Schedule by Zapier"
- Check every day and hit continue
- Select a time and make sure trigger on weekends is turned on
- Double check your settings and hit continue
- On the left hit add a step - and search for webhook by Zapier
- Select post as action and continue
- Past in the url of our recently generated webhook in the url field
- Make sure "Payload Type" is set to form and hit continue
- check settings and hit the test button
- Check your Netlify site if there has been triggered a new deploy
- If that worked hit finish
- Give your zap a name, example: "Automatic deploy Yellowcake" and make sure your zap is turned on
That's it, you'r now ready to use scheduled content!!
Mailchimp integration
https://hooks.zapier.com/hooks/catch/2881617/ea5exg/
- Go to Zapier.com and login
- Hit make a zap button in the right top corner
- Search for webhook by Zapier and select catch hook and continue to next step
- In most cases leave this field empty and continue
- Copy the generated url
- Now go to the form settings in you Netlify project
- Find the form notifications section click the add notification button
- Select the option
outgoing webhook
- Set the event to listen for
- Paste in our recent generated url in the URL to notify field
- Select your form and save settings
- Open your website navigate to your form, fill it out and send the data
- Go back to Zaper and see if your form data has come trough.
- Hit continue and add a new step on the left side of the screen
- Search for MailChimp and select add/update subscriber
- Select MailChimp account or add one and hit the test button
- if succeeded hit continue button
- Select your MailChimp list and select the subscriber email address
- Fill in other settings for your needs and continue
- Hit send test to MailChimp button and hit finish if succeeded
- Give your Zap a name and make sure your zap is turned on
- Submit your form one last time and see if all data is coming trough to MailChimp
- That's it!