Developer toolkit for WordPress block themes
Build custom WordPress sites with less repeated plumbing.
PorterWP turns theme-owned configuration and PHP into content models, custom blocks, Query Loop tools and production-ready WordPress behaviour.
Theme-owned
Schema-driven
Built for the Site Editor
porter/
config/
porter.json
blocks.json
posttypes.json
taxonomies.json
acf.json
blocks/
inc/WordPress
6.4+
Tested up to
7.0.3
PHP
8.2+
ACF block scaffold
Blocks v3
A clearer project foundation
WordPress conventions, organised for professional teams.
PorterWP does nothing until a theme asks it to. The theme describes the project, PorterWP registers the required WordPress features, and developers keep the application logic close to the code they own.
01
Your theme stays in control
Content models, asset declarations, block locations and project PHP remain inside the custom theme, where the development team expects to find them.
02
Configuration handles structure
Use focused configuration files for repeatable WordPress registration. Use PHP for the logic that makes each client project different.
03
Projects become easier to read
A consistent folder structure helps developers understand what a theme registers, where a block lives and how a feature is wired into WordPress.
One toolkit, two useful explanations
Choose the view that fits your role.
For developers
A practical base for bespoke block themes
Model content, scaffold ACF Blocks v3, declare assets, extend Query Loops and keep project-specific code in a predictable theme structure.
For site owners
Understand what your developer has recommended
Learn where PorterWP fits, why a production site needs a licence and which questions to settle with your developer before purchasing.
Core capabilities
Useful structure from the content model to production.
MODEL
Post types and taxonomies
Describe project content structures in focused theme configuration and let PorterWP handle WordPress registration.
BLOCKS
ACF Blocks v3 scaffolding
Keep metadata, fields, PHP templates, styles and optional scripts together in a component-shaped block folder.
QUERY
Scoped filters and helpers
Connect filters to the intended core Query Loop and build project query rules without replacing WordPress query behaviour wholesale.
CONFIG
Assets and theme support
Declare public and editor assets, WordPress theme supports, image sizes and block configuration alongside the theme.
EDITOR
Site Editor performance
Bounded preview caches and lightweight ACF placeholders reduce repeated collection preview work in the Site Editor.
LIFECYCLE
Production-minded helpers
Use theme-scoped caches, managed invalidation, scheduled status helpers and guarded integration points built for real WordPress projects.
Clear boundaries
PorterWP is a toolkit, not a page builder or an off-the-shelf theme.
It works beside WordPress and a custom block theme. The theme supplies the design and project decisions. PorterWP supplies a consistent way to connect them to WordPress.
Ready for the next build?