Next.js + WordPress

💀 It's headless WordPress!

Features

• Next.js w/ TypeScript
• WordPress in a Docker container with PHP 8.1
• Self-signed SSL certificate from Traefik
• Apollo Client w/ WP GraphQL
• On-demand revalidation
• Date based blog routing (YYYY/MM/DD/slug)
• SEO via Yoast
• Menus support
• Preview support
• Comments support
• Post reactions support
• Custom Post Types via CPT UI
• Custom Fields via Advanced Custom Fields
• ESLint, Stylelint, Prettier, and more!

---

Demo

See a fully working, production site running this stack at https://gregrickaby.com

---

Monorepo

This project is a monorepo managed by Turborepo.

nextjs-wordpress
├── apps
│   ├── docs
│   ├── nextjs
│   └── wordpress
├── packages
│   ├── eslint-config-custom
│   ├── nextjs-wordpress-plugin
│   ├── nextjs-wordpress-theme
│   ├── prettier-config-custom
│   ├── stylelint-config-custom
│   └── tsconfig
└── turbo.json

apps/

The applications directory. This includes the documentation, Next.js (frontend), and WordPress (backend).

packages/

Shared packages used by the apps. This includes ESLint, Stylelint, Prettier, and TypeScript configs. As well as the WordPress plugin and theme.

turbo.json

The repo config file. Learn more about configuring Turborepo.

---

Quick Start

Prequisites

1. Docker Desktop

2. Node LTS

3. Clone this repo:

npx degit gregrickaby/nextjs-wordpress nextjs-wordpress

4. Set up your dev environment:

npm run setup

---

Full Documentation

The docs are a work in progress. You can view them here.

---

Contributing

Contributions are welcome! Please see the contributing guidelines for more information.

---

Props

A special thanks to the following people:

• Rae Van Epps wrote the bulk of the PHP code for the Next.js WordPress Plugin, giving this project a jumping off point.
• Amor Kumar insipired me to deep dive into Docker with his BYOB Headless WordPress project.
• John Jeeves and Adam Hollister for their work on registering Gutenberg Blocks in the WordPress REST-API.
• Jason Bahl for his tireless work on WP GraphQL, and all of our chats/DMs over the years.

I ❤️❤️❤️ the open source community, and hope this project inspires you to create something awesome.

Cheers! 🍻

---