Back to Portfolio
Open-source plugin Case Study
Headless Portfolio CMS – WordPress Plugin logo

Headless Portfolio CMS – WordPress Plugin

An open-source WordPress plugin that turns WordPress into an API-first backend for Next.js, React, Vue, Astro and Gatsby, published on WordPress.org.

Key Result
Published on WordPress.org • 9 content types • 13-section homepage builder • REST API with on-demand revalidation
Headless Portfolio CMS case study cover: WordPress admin with the plugin's Projects screen, connected through a REST API to Next.js, React, Vue and Astro websites

The Starting Material

Portfolio and marketing sites often hardcode their projects, experience and testimonials into the frontend. Every update then means a code change and a redeploy. The usual alternative, a theme-bound WordPress build, ties the design to the CMS. We wanted a frontend that is free to use any framework, with content that anyone on the team can edit.

The Formula

  • Nine content types out of the box: Projects, Experience, Education, Skills, Testimonials, Resumes, Services, Clients and a contact inbox, each with purpose-built fields such as GitHub links, live demo links, tech stacks and skill levels.
  • A clean REST API with strictly typed, nested JSON, plus a built-in API reference dashboard inside the WordPress admin.
  • On-demand revalidation. When content is published or updated, the plugin calls the Next.js frontend's revalidation endpoint, so static pages stay fresh without a manual deploy.
  • A contact form API with rate limiting (5 requests per IP per hour), sanitized input, inbox storage and email notifications.
  • A homepage builder with 13 configurable sections, such as hero, about, services, tech stack, experience, projects, testimonials and contact, served from a single endpoint.
  • Central settings for CORS, API cache duration, profile details and default SEO metadata, plus taxonomies for technologies, categories and industries.
  • Secure and lightweight. Public endpoints are read-only, admin settings use WordPress nonces and capability checks, and the plugin loads no frontend assets.

The Reaction

  • Published in the WordPress.org plugin directory as open-source software.
  • Three releases so far: the initial public release, a settings and data-migration overhaul, and the homepage builder.

In production

The stack behind adilashrafi.com is a Next.js frontend on headless WordPress, with an alchemy-themed identity in dark navy, #019CFF and #FE5401, and sections for services, experience, case studies, industries and contact. Both repositories ship with production-grade READMEs.

What this means for your business

If your site is stuck between hardcoded pages and a slow, theme-bound build, a headless approach gives you speed, control over SEO and an editor your team already knows. We build these stacks, and we deliver them white-label for agencies. Talk to Markimist about a headless WordPress build.

Stack

WordPress REST API, modular PHP (PSR-4), Next.js, with React, Vue, Astro and Gatsby supported.

Let's Write Your Brand's Next Chapter

We'll build a customized setup that optimizes your checkout pipelines, compounds keyword positioning, and generates higher marketing returns.