Back to Portfolio
Open-source plugin Case Study

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

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.
Project Snapshot
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.