Skip to main content

Quick Setup

If you're new to Next.js, we recommend reviewing Next.js docs.

System Requirements

  • Node.js 16 or later
  • NPM >= 7
  • WordPress >= 5.9 (prior versions might work but haven't been tested).


The easiest way to get started with HeadstartWP is by using create-next-app with the official starter project.

npx create-next-app --use-npm -e

Then run npm run dev and open http://localhost:3000 in your browser.

Environment Variables

By default, the starter project will point to Either change the NEXT_PUBLIC_HEADLESS_WP_URL variable or create a .env.local file to override the default env variables.

If you're developing locally and using HTTPS with WordPress and you don't have valid certs, you will need to add NODE_TLS_REJECT_UNAUTHORIZED=0 as an env variable


Something Missing?

If something is missing in the documentation or if you found some part confusing, please file an issue for the documentation repository with your suggestions for improvement.