Skip to content
Nuxt headless using WordPress REST API
PHP JavaScript CSS Vue
Branch: master
Clone or download
Alessandro Giordo
Alessandro Giordo removed scrollama
Latest commit 98973a5 Nov 12, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets updating Jun 15, 2019
components updated deps Oct 19, 2019
layouts updating Jun 15, 2019
middleware removed hardcoded stuff Dec 13, 2018
mixins updating Jun 15, 2019
pages removed scrollama Nov 11, 2019
plugins updating Jun 15, 2019
static added changes Jun 15, 2019
store updating Jun 15, 2019
wordpress updating Jun 15, 2019
.babelrc updating Jun 15, 2019
.editorconfig added boilerplate Nov 24, 2018
.eslintrc.js added boilerplate Nov 24, 2018
.gitignore upgrading v2.5 Mar 21, 2019
.travis.yml changed config Oct 19, 2019 added new link Mar 21, 2019
LICENSE Initial commit Nov 24, 2018 added changes Jun 15, 2019
greenkeeper.json ignore other config Mar 31, 2019
nuxt.config.js updating Jun 15, 2019
package.json removed scrollama Nov 11, 2019
yarn.lock removed scrollama Nov 11, 2019

Nuxt Headless

Greenkeeper badge Build Status libera manifesto

Nuxt + WordPress REST API boilerplate

Live demo link


[ 1.2.0 ]

  • 15 - June - 2019
    • Nuxt updated to v2.8.1
    • Updated LazyImage for better lazy loading
    • Added Defer mixin

[ 1.1.0 ]

  • 21 - March - 2019
    • Nuxt updated to v2.5
    • Added postcss-nested
    • added more docs and comments

Use in production?

Please note this is a boilerplate, it contains some defaults you might want to pay attention to:

  • CORS - You should set this to work only on your website url when in production or staging, work locally on your machine for dev.
  • Plugins and Theme, most of these can be removed, but you'll need ACF (free version is OK) to make it work.

Installation Steps

  1. Copy the contents of the /wordpress folder in your wordpress installation (make sure to edit wp-config.php)

  2. Make sure you activate all the plugins and set Moustache Design as your active theme in wordpress (you can rename it if you want)

  3. Set permalinks in wordpress to anything but the default (I suggest /%postname%/)

  4. Make sure you set your CORS correctly to point to your website when in production/staging

  5. Make sure assets/config.js reflects your configuration and endpoints for the WP rest api and wordpress url

  6. You can edit all the files and config freely. This is MIT licensed, but credit is welcome.

Check how I used this in my blog at

Vuex config

The current config allows to either initialise the api calls in nuxtServerInit, or commit fetch mutations from each page. You can otherwise skip Vuex and load the data for each page using asyncData.

Build Setup

# install dependencies
$ yarn # Or npm install

# serve with hot reload at localhost:3000
# service worker is disabled in dev
$ yarn dev # or npm run dev

# build for production and launch server
$ yarn build # or npm run build
$ yarn start # or npm start

# generate static project
$ yarn generate # or npm run generate


I suggest now for SSR websites using nodeJS, or Netlify for static sites (free hosting) using yarn generate

You can of course use this as middleware following Nuxt Docs below.

Nuxt Docs

For detailed explanation on how things work with Nuxt, checkout the Nuxt.js docs.

How to contribute

All PRs are very welcome and much needed. Steps to contribute:

  • Fork development branch
  • Make your changes
  • Make a PR
  • PR is either approved or sent back
  • If PR is approved I'll include it in the next release
You can’t perform that action at this time.