Build With Wordpress

Build with WordPress Claude Code Plugin

Describe a website in plain English, get a complete WordPress block theme deployed to your local Studio site — ready to push to WordPress.com or Pressable.

What this does

Building WordPress themes from scratch is complex — theme.json, block markup, template parts, design systems, responsive layouts. This plugin handles all of it. You describe your site (e.g., "A landing page for my pottery studio called Clay & Fire"), pick from 3 generated design directions, and get a fully deployed theme on a local WordPress Studio site.

There are two workflows:

• /quick-build — Fast, single-session flow. Describe your site, review the spec, pick a design, and get a live theme in minutes.
• /design-site — Multi-phase professional pipeline with style tile iteration, page layout reviews, full-page mockups, and a live design gallery that auto-refreshes as artifacts are generated.

Prerequisites

1. Claude Code — Install Claude Code if you haven't already.
2. WordPress Studio — A local WordPress environment from Automattic. Download Studio, then enable the CLI so the studio command is available in your terminal (CLI docs).
3. Node.js 18+ — Needed by the bundled block markup validator that runs after theme generation.

Installation

1. Clone this repo (or note the path if you already have it):

   git clone https://github.com/Automattic/claude-code-wordpress.com.git
   

2. Start Claude from your Studio sites folder with the plugin flag:

   cd ~/Studio
   claude --plugin-dir /path/to/claude-code-wordpress.com
   

Claude must be started from the folder where your Studio sites live (or a subdirectory of it). The plugin checks this on first run and will prompt you if you're in the wrong directory.

Getting started

Here's what a typical /wordpress.com:quick-build session looks like:

1. Run the command — Type your site description after the command:

   /wordpress.com:quick-build A landing page for my pottery studio called Clay & Fire