/gatsby-wordpress-balsa-theme

A Feature rich Gatsby theme plugin for creating blogs from headless WordPress CMS.

Primary LanguageTypeScriptMIT LicenseMIT

Draftbox

gatsby-wordpress-balsa-theme

A Gatsby theme plugin for creating blogs from headless WordPress CMS.

Turn your WordPress blog into a lightning fast static website. This Gatsby theme is a frontend replacement of the WordPress engine featuring the Balsa theme skin and functionality. All content is sourced from a headless WordPress CMS.

This theme is being used at Draftbox. Get lightning fast, secure front-end for your WordPress or Ghost blog, in 5 minutes or less, without coding. For our fellow devs, we also provide code export feature.

Demo

Play with the Demo to get a first impression.

Features

  • Balsa theme from Draftbox
  • SEO optimized
  • Fully responsive
  • Gatsby images
  • Styled 404 page
  • RSS Feed
  • AMP Pages
  • Sitemap
  • Contact Form
  • Subscribe Form
  • Social Sharing
  • Composable and extensible

Quick Start

Head over to the starter repo to get up and running quickly! The starter is recommended if you are creating a new site.

Installation

This repository contains the example code and the Gatsby theme. If you are here to install the Gatsby theme plugin in your existing project, check out the theme specific README for further details.

In case you want to work with this repository (for local development, pull requests, etc.):

  1. Clone or fork this repository:
git clone https://github.com/draftbox-co/gatsby-wordpress-balsa-theme.git
cd gatsby-wordpress-balsa-theme

create .wordpress-config.json in example directory and add your wordpress config.

If your wordpress blog is self hosted it should look like

{
  "baseUrl": "yourwordpressblog.com",
  "protocol": "https",
  "hostingWPCOM": false,
  "useACF": true,
  "includedRoutes": [
    "**/categories",
    "**/posts",
    "**/pages",
    "**/media",
    "**/tags",
    "**/taxonomies",
    "**/users"
  ]
}

if your blog is hosted on wordpress.com you will have to add few extra keys for reference check out wordpress-source-docs.

  1. Run yarn in directory where you cloned theme to install dependencies.

  2. Run yarn workspace example develop to start the example locally.

Authors

Contributions

PRs are welcome! Consider contributing to this project if you are missing feature that is also useful for others.

Copyright & License

Copyright (c) 2020 Draftbox - Released under the MIT license.