Skip to main content

Theme Elementary

Build a WordPress block theme from this starter theme, then keep the examples and tools your project needs. Start with Getting Started.

Two ways to work​

This starter is set up and extended in two ways: AI skills (guided — /init and /scaffold in Claude Code) or the raw CLI (manual — npm run init and npx wp-tooling add).

  • /init / npm run init — names the theme and selects which example sets ship. Run once per repo; see Initialization.
  • /scaffold / npx wp-tooling add — adds one feature (a block, shortcode, settings page, service, and so on), wired into Main::CLASSES. See Scaffolding.

Both are valid — pick the CLI when you want full control over every input, or the AI skill when you want the wizard to infer conventions from a brief and check its own work.

I want to…Read
Create a theme and see it runningGetting Started
Understand init prompts or change options laterInitialization
Edit source, run checks, and buildLocal development
Find the supplied examples and infrastructureIncluded features
Generate one feature with CLI or AIScaffolding
Extend the theme by handDevelopment guide

Further reading​

Shared dependencies​

PHP contracts: wp-primitives. Init and scaffold tooling: wp-tooling.

Command reference​

TaskCommand
Personalize the theme (AI)/init <brief>
Personalize the theme (CLI)npm run init
Check current identity/feature statenpm run init -- --list
Generate a feature (AI)/scaffold <description>
Preview a feature (CLI)npx wp-tooling add wp/<kind> ... --dry-run
Watch and build assetsnpm start / npm run build:prod
Run PHP testsnpm run test:php
Run PHP checkscomposer phpcs && composer phpstan