Gatsby v2 WordPress Starter

This starter is forked from the gatsby-starter-netlify-cms and modified to use WordPress instead of netlify-cms.

Demo: https://gatsby-starter-wordpress.netlify.com/

Warning

: Using yarn upgrade or npm update will break the site. See GatsbyCentral/gatsby-starter-wordpress#36 and gatsbyjs/gatsby#10262 for more info. Hopefully we'll have a resolution soon. - 19 Dec 2018

Use it now

gatsby new NAME https://github.com/GatsbyCentral/gatsby-starter-wordpress

• Edit gatsby-config.js, change baseUrl
  • Make sure you have at least 1 post and 1 page on your WordPress site
  • Make sure at least 1 post has at least 1 tag
• Rejoice
  • File any issues here

Known Limitations

• This is based on the netlify starter which uses bulma. This adds 150KB to every built page.
• Your WordPress site must have at least 1 post with 1 tag, or the starter will crash
• Nested pages / categories will not render with nested pages
  • A WordPress page like /about/team/ will render on Gatsby as /team/
  • Likewise for categories
  • Discussion here https://github.com/GatsbyCentral/gatsby-starter-wordpress/issues/24

CSS Processing

This plugin uses gatsby-plugin-purgecss and bulma. The bulma build would otherwise be ~170K which adds 170K to each of your built HTML pages. However, with purgecss this is reduced 90%.

Contributors

This starter was forked from the netlify starter by the GatsbyCentral crew. Additional contributions were gratefully received from the following folks:

• https://github.com/tomByrer
• https://github.com/dajocarter