/wordpress-next-starter

Starter kit for using WordPress as a headless CMS with Next.js

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Introduction

This is a quick, no-frills starter project that will allow you to connect a Next.js project to a WordPress instance running in headless mode.

This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, you'll need to install the dependencies:

yarn install
# or
npm install

Adding an environment file

This project makes use of an external WordPress instance as a GraphQL API endpoint. If you look in the /lib/api.js file, you'll see we make reference to an environment variable, process.env.WP_API_URL.

To consume this, you'll need to make a new file in the project root called .env.local.

Once you've created the file, add the following:

WP_API_URL=http://demo.robkendal.co.uk/graphql/

Note I'm happy for you to temporarily use my personal demo site using the URL above. However, please be aware that it might not function as you expect, you have no control over the site, it's content or fields, and the site may be taken down without notice, which will cause unintended side effects for your own project. Please look to create your own WordPress instance and use that moving forward :)

Running the project

Lastly, to run and test the project, run the development server:

npm run dev
# or
yarn dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying page files under the /pages/ path. The page auto-updates as you edit the file.

Learn More

To learn more about using WordPress as a headless CMS with Next.js, check out my original blog article series:

To learn more about Next.js, take a look at the following resources:

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!