Postlight's Headless WordPress + React Starter Kit is an automated toolset that will spin up two things:
- A WordPress backend that serves its data via the WP REST API.
- A server-side rendered React frontend using Next.js.
You can read all about it in this handy introduction.
- An automated installer script which bootstraps a core WordPress installation.
- The WordPress plugins you need to set up custom post types and custom fields (Advanced Custom Fields Pro and Custom Post Type UI).
- Plugins which expose those custom fields and WordPress menus in the WP REST API (ACF to WP API and WP-REST-API V2 Menus).
- All the starter WordPress theme code and settings headless requires, including pretty permalinks, CORS
Allow-Originheaders, and useful logging functions for easy debugging.
- A mechanism for easily importing data from an existing WordPress installation anywhere on the web using WP Migrate DB Pro and its accompanying plugins (license required).
- A starter frontend React app powered by Next.js.
- A Docker container and scripts to manage it, for easily running the frontend React app locally or deploying it to any hosting provider with Docker support.
Let's get started.
Before you install WordPress, make sure you have all the required software installed for your operating system.
- OS X: You'll need Homebrew and Yarn installed.
- Windows: To install under Windows you need to be running the 64-bit version of Windows 10 Anniversary Update or later (build 1607+). The Linux Subsystem for Windows should be installed and enabled before proceeding. Then, you'll need the prerequisites for Ubuntu Linux, detailed below, set up.
- Ubuntu Linux: You'll need the latest version of NodeJS, Yarn and debconf-utils installed first. Follow this simple guide to get the latest version of NodeJS installed. Install the rest of the packages using the
apt-getpackage manager. Note: During the WordPress installation, you may be asked to enter the root password at the prompt due to the use of the
The following command will get WordPress running locally on your machine, along with the WordPress plugins you'll need to create and serve custom data via the WP REST API.
> yarn install && yarn start
When the installation process completes successfully:
- The WordPress REST API is available at http://localhost:8080
- The WordPress admin is at http://localhost:8080/wp-admin/ default login credentials
Import Data (Optional)
To import data and media from a live WordPress installation, you can use the Migrate DB Pro plugin, which is already installed. To do so, in the
robo.yml file, set the plugin license and source install. Run
robo wordpress:setup, then run
robo wordpress:import to pull in the data.
Extend the WordPress API
At this point you can start setting up custom fields in the WordPress admin, and if necessary, creating custom REST API endpoints in the Postlight Headless WordPress Starter theme. The primary theme code is located in
wordpress/wp-content/themes/postlight-headless-wp. As you modify the theme code, be sure to use WordPress coding standards.
To spin up the frontend client app, run the following commands:
> cd frontend && yarn install && yarn run dev
The Next.js app will be running on http://localhost:3000.
Most WordPress managed hosting services don't also host Node applications, so usually you will need another service to run the client app. That's why we've packaged the frontend app in a Docker container, which can be run locally or deployed to a hosting provider with Docker support like AWS Elastic Beanstalk.
Once you have Docker installed on your computer, you can run the container locally using this command:
> yarn run deploy