Headless WordPress

I build headless sites with a Next.js or React frontend on a WordPress backend, with content delivered through the REST API or WPGraphQL. You get modern speed with the editing screen your content team already knows.

What you get

  • WordPress backend with custom post types, ACF and REST or WPGraphQL endpoints
  • Custom PHP plugins for any logic the API needs
  • Next.js or React frontend in TypeScript and Tailwind CSS
  • Preview and revalidation so editors see changes quickly
  • SEO metadata, sitemap and redirects on the frontend
  • Deployment on Vercel or Cloudflare
  • A clear written recommendation on whether headless is the right fit

Who is this for?

Content teams that edit in WordPress every day and do not want to learn a new CMS. Companies that need a React frontend for speed, interactivity or a shared design system.

What do I build?

Both halves. On the WordPress side I model content with custom post types and Advanced Custom Fields and expose it through REST endpoints or WPGraphQL. I write custom PHP plugins where the API needs logic, such as phone OTP verification. On the frontend I build the Next.js or React app in TypeScript that consumes the API, with server rendering, metadata, sitemaps and redirects handled on the frontend. Editors get preview and revalidation so a change shows up quickly. I also give a straight recommendation on whether headless is the right fit, because for a small marketing site plain WordPress or plain Next.js is often simpler.

How I build it

WordPress with PHP, custom post types and ACF as the content store. REST API or WPGraphQL as the contract between the two halves. Next.js with React, TypeScript and Tailwind CSS on the frontend, deployed on Vercel or Cloudflare. TypeScript catches malformed inputs at compile time, and validation at the form boundary catches the rest. Keeping the business logic and data behind a REST API lets the frontend stay thin, and a shared input or layout fix lands on both sides at once. Where a team already has WordPress logins, I can start React tools inside WordPress as a plugin and move them to a standalone frontend later.

What does it look like in practice?

PropAlert Real Estate Website runs custom plugins and a REST API under a custom theme, with JavaScript handling phone OTP verification inside the form.

What results can you expect?

PropAlert's team can trust that every enquiry carries a verified phone number. In each case the people editing or entering data kept the screens they already knew.

Process

How this engagement runs

Fit check: whether headless beats plain WordPress or plain Next.js for your team.

Content model: post types and fields agreed with your editors.

API first: endpoints built and tested on staging before any frontend work.

Frontend: pages built against the live API on a staging URL.

Launch with redirects, metadata checks and editor training.

Proof

Projects built with this service

Real estate

PropAlert Real Estate Website

2024

PropAlert WordPress website for an Indian real estate data platform, built by Mohit Goyal with custom plugins and OTP phone verification wired into WPForms. The engagement ran from July to August 2024 as a freelance project, and the site is live at propalert.in. PropAlert helps home buyers track under-construction projects and avoid stalled developments. The site claims coverage of 57,000 developers in 44 cities and partnerships with 200 banks and institutions. The problem it solves is unfamiliar to most buyers, so the site had to explain it clearly before asking for anything. It also had to capture leads that the sales team could act on and take payments. Lead quality mattered. An enquiry with a wrong or fake phone number is worth nothing to a business that follows up by phone. I built the site on WordPress with a custom theme. The pages use long-form sections for buyer pain points, how the service works, media coverage and videos. A first-time visitor understands the problem and the product before reaching a form. I built Pay Now and Enquire Now flows for the two actions the business wanted. Because lead quality mattered, I wrote custom plugins and connected WPForms to an OTP (one-time code) API, so every enquiry comes with a verified phone number before it reaches the team. The stack was WordPress, PHP, WPForms, a REST API and JavaScript. A custom theme rather than a builder gave me control over the long-form layout and kept the page weight down. WPForms was kept as the form layer because the team already knew it. The verification was added around it with custom plugins and the OTP API rather than replacing it, so the team's workflow did not change. JavaScript handles the OTP step in the form itself, so the visitor verifies their number without leaving the page. The custom plugins keep the verification logic separate from the theme, so a theme change later does not touch the lead flow. No traffic or conversion metrics were measured for this work. The team can now trust that every enquiry has a verified phone number, take payments through the site, and edit the explanatory content as the product grows. The site is live at propalert.in. Getting fake phone numbers through your lead forms? Send me your next project and I will reply with a plan for verified enquiries.

WordPress PHP WPForms REST API

Related case studies and guides

Questions

Frequently asked

When is headless WordPress worth it?+

When you need a fast React frontend and your team already edits in WordPress. For a small marketing site, plain WordPress or plain Next.js is often simpler.

Can I keep my existing WordPress content?+

Yes. The content stays in WordPress. Only the frontend changes.

REST API or WPGraphQL?+

I pick by the shape of the content. REST ships with WordPress and is simpler to maintain. WPGraphQL suits pages that pull many related records in one request.

Can you build React tools inside WordPress instead of going fully headless?+

Yes. React apps can run inside WordPress as a custom plugin, so your team keeps the logins and permissions it already has without a full headless rebuild.

How much does a headless WordPress site cost?+

It depends on scope. Send me the brief, the pages or features you need and any design you have, and I will reply with a written scope and a quote.

Other services

Let's build

Have a site that needs to be fast, rank and convert?

Open to Work. Usually replies within a day.