A developer-first toolkit for WordPress block themes
Build block themes without rebuilding the plumbing.
PorterWP gives professional WordPress developers a repeatable, configuration-first foundation for content models, ACF blocks, assets, filters and theme code, while keeping WordPress and your theme firmly in control.
WordPress 6.4+ · Tested through WordPress 7.0.3 · PHP 8.2+ · Full ACF integration with ACF PRO
Less boilerplate. More time for the theme.
Keep each project’s content, design and business logic in the theme. Let PorterWP handle the repeatable registration, discovery and lifecycle work around it.
Describe it in JSON
Define post types, taxonomies, option pages, asset handles, block discovery and styles in readable, version-controlled configuration instead of repeating registration code.
Build modular ACF blocks
Keep block metadata, PHP, templates, local field JSON and assets together. PorterWP discovers and registers the block while your theme owns its markup and behaviour.
Add serious content filters
Add schema-validated faceted filtering to Query Loops, including search, taxonomy, post type, dates, authors and sorting, with controlled extension points for project-specific meta and location logic.
Load theme code predictably
Organise reusable PHP beneath porter/inc. PorterWP loads it in a deterministic order, respects exclusions and rejects unsafe cached paths.
Stay fast in production
Theme-aware caches avoid repeated file scans and JSON decoding in production, while local, development and staging environments stay responsive to everyday theme changes.
Upgrade with fewer surprises
Scoped caches, coordinated rewrite updates, graceful ACF dependency checks and scheduled-task cleanup make PorterWP easier to operate across a portfolio of sites.
ACF PRO powers PorterWP’s complete custom-block and option-page integration. If a required ACF API is unavailable, the dependent integration steps aside while unrelated PorterWP features continue to run.
A workflow your team can repeat
PorterWP turns the setup you repeat on every professional build into a shared convention that is easier to version, review and hand over.
01. CONFIGURE
Describe the theme
Add the content model, assets, block folders, styles and feature settings to a small set of JSON files inside the theme.
02. BUILD
Write project code
Build native blocks, templates and PHP around the project’s real requirements. PorterWP supplies conventions, not a proprietary page-builder layer.
03. SHIP
Deploy with confidence
Move the theme through environments with predictable registration, cache invalidation and lifecycle behaviour already handled.
Keep WordPress at the centre.
PorterWP works with theme.json, block metadata, the Site Editor, WP_Query, the REST API and familiar theme files. Your content remains native WordPress content, and your project’s source stays readable to the next developer.
Native by design
No proprietary content format and no replacement editor.
Clear to hand over
Configuration and project code live together in the theme.
Ready to extend
Hooks and helper APIs cover the places real client builds differ.
Make the next theme easier to build, and the next one easier still.
Bring a repeatable architecture to your next professional WordPress block theme with PorterWP.