Pattern Builder

A WordPress plugin for creating, editing and organising block patterns in the admin. Theme patterns (PHP files in patterns/) and user patterns (wp_block posts) are managed in one interface, edited in the WordPress editor, and optionally shared through patternbuilderwp.com. Patterns a plugin registers are browsable beside them; copying one into the theme, with the patterns it places, makes it yours to edit.

Agents can drive the same operations, and read and write the theme's templates and template parts, through WordPress core's Abilities API, and as MCP tools where the MCP Adapter plugin is active.

Requirements

WordPress 6.8+ · PHP 7.4+

Install

Download a release and install it as a plugin, or from source:

git clone https://github.com/Twenty-Bellows/pattern-builder.git
cd pattern-builder
npm install && composer install
npm run build

npm run start boots a local WordPress with the plugin active (requires Docker). npm run watch rebuilds on change.

Documentation

docs/architecture.md	How the plugin is built.
docs/abilities.md	The agent interface.
docs/cloud.md	The patternbuilderwp.com integration.
docs/collections.md	Collections.
docs/dependencies.md	Dependency trees and attribution.
CLAUDE.md	Commands, invariants and coding standards.

Related

• Synced Patterns for Themes — the runtime half, for shipping a theme built with Pattern Builder.
• patternbuilderwp.com — the service.

License

GPL-2.0-or-later. Built by Twenty Bellows. Issues: GitHub.