Home

Home

StrataWP is a modern, TypeScript-first WordPress theme framework — CLI scaffolding, a Vite dev server, opt-in PHP components, and a production deploy pipeline for Full Site Editing block themes.

StrataWP is a next-generation WordPress theme framework that brings modern development practices to block-theme development. Built from the ground up with TypeScript, Vite, and current tooling, it pairs a fast hot-reloading dev server with CLI scaffolding, a component-based PHP core, design-system integration, comprehensive testing, and a one-command deployment pipeline — so building, testing, and shipping WordPress themes is fast, type-safe, and enjoyable.

Note Current version: v2.0.0 (GPL-3.0-or-later). See the Changelog for the full release history.

Feature highlights

Feature	What it gives you
TypeScript-First	Full type safety across PHP and JavaScript
Vite-Powered	Fast HMR and sub-second rebuilds
Block Theme (FSE)	Full Site Editing support out of the box
Block Auto-Registration	Discovers and registers Gutenberg blocks automatically
PHP Hot Reload	See PHP template changes without a page refresh
Three Example Themes	Basic, Advanced, and Store starters to build from
CLI Scaffolding	Generate templates, parts, components, and blocks
Design Systems	Tailwind CSS or UnoCSS with WordPress preset mappings
Comprehensive Testing	Vitest unit tests and Playwright E2E
Component Explorer	Interactive, Storybook-style component browser
Headless WordPress	REST API client, React hooks, Next.js integration
Production Deployment	SFTP/FTP/SSH deployment with change detection
Post-Deploy Automation	Cache flush, OPcache reset, backup cleanup, validation
FSE Template Sync	Sync Site Editor templates via WP-CLI over SSH
Environment Sync	Database sync between local and production
Rollback Support	Automatic snapshots before every deployment

30-second quick start

Prerequisites: Node.js 18+, pnpm (or npm), PHP 8.1+, WordPress 6.7+, and a local WordPress environment (Local by Flywheel, MAMP, Docker, etc.). Run the command outside your WordPress directory (e.g. in ~/Projects) — the CLI symlinks the theme into WordPress for you.

npx create-stratawp my-theme
cd my-theme
pnpm dev

The CLI guides you through setup (name, template, CSS framework), auto-detects your WordPress installation, links the theme for you, and starts the hot-reload dev server at http://localhost:3000. Then open your WordPress site and activate the theme.

Tip New here? Walk through the full tutorial on Installation & Quick Start.

Documentation hub

Every wiki page, grouped by what you're trying to do.

Get started

• Installation & Quick Start — install prerequisites and scaffold your first theme
• Core Concepts — the mental model: components, blocks, and the dev loop
• Project Structure — what lives where in a StrataWP theme and monorepo

Build

• CLI Reference — every stratawp and create-stratawp command and flag
• Blocks, Patterns & Design Systems — author blocks, patterns, and design systems (Tailwind/UnoCSS)
• Example Themes — the Basic, Advanced, and Store starter themes
• Headless WordPress — REST API client, React hooks, and Next.js front-ends

Ship & maintain

• Testing & Quality — Vitest unit tests, Playwright E2E, and custom matchers
• Deployment — SFTP/FTP/SSH deployment with change detection and post-deploy automation
• Environment Sync & Rollback — database sync, snapshots, and rollback

Go deeper

• Architecture & Packages — the monorepo, published packages, and how they fit together
• AI, Agent Skills & MCP — bundled WordPress agent skills and the @stratawp/mcp server
• Contributing & Releases — contribute code, run the monorepo, and cut releases
• FAQ & Troubleshooting — common issues and fixes

Where to next

New here? Start with Installation & Quick Start — it takes you from an empty folder to a running, hot-reloading theme step by step.

Want to see what changed in the latest release? Read the Changelog, and check the ROADMAP for what's coming.