HeadPress
HeadPress — Complete Headless WordPress toolkit with setup wizard, diagnostics, ACF support, and Astro integration.
by Martijn Bokma · github.com/martijnbokma/headpress · website
★ 0stars
0forks
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/martijnbokma/headpress/archive/refs/heads/main.zipUniversal Headless Setup Wizard
WordPress plugin for effortless, enterprise-grade headless WordPress setups with Astro.
Features
- System Diagnostics: Automatic health verification of PHP version, permalink rules, REST API reachability, WPGraphQL engine, Custom Fields engine (SCF / ACF), and Frontend Gatekeeper.
- Domain & Routing: Guidance and configuration for single-domain Cloudflare Worker edge reverse proxies vs. subdomain separation.
- Astro Connection: Live round-trip connection tester and HMAC SHA-256 webhook secret pairing for instant Astro cache revalidation (
/api/revalidateand/api/webhooks/wordpress). - Environment Variables: Automatic export of pre-configured environment variable snippets for Astro (
apps/site/.env) and Cloudflare Workers. - Universal Page Modeler: Registers flexible content layouts (Hero, Features, Pricing, FAQ, Testimonials, CTA, Contact) exposed to WPGraphQL with zero vendor lock-in.
Requirements
- PHP >= 8.2
- WordPress >= 6.5
- WPGraphQL
- Secure Custom Fields (SCF) or ACF Pro
- WPGraphQL for ACF
Development
# Install dependencies
bun install
# Start standalone local WordPress on http://localhost:8912
bun run env:start
# Run static checks
composer check
# Build release zip
bun run build:zip