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 intoMain::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 running | Getting Started |
| Understand init prompts or change options later | Initialization |
| Edit source, run checks, and build | Local development |
| Find the supplied examples and infrastructure | Included features |
| Generate one feature with CLI or AI | Scaffolding |
| Extend the theme by hand | Development guide |
Further reading
- Asset builds, live reload, and Tailwind cover theme-specific configuration.
- Contributing and maintenance are for developers maintaining the starter theme itself.
Shared dependencies
PHP contracts: wp-primitives. Init and scaffold tooling: wp-tooling.
Command reference
| Task | Command |
|---|---|
| Personalize the theme (AI) | /init <brief> |
| Personalize the theme (CLI) | npm run init |
| Check current identity/feature state | npm run init -- --list |
| Generate a feature (AI) | /scaffold <description> |
| Preview a feature (CLI) | npx wp-tooling add wp/<kind> ... --dry-run |
| Watch and build assets | npm start / npm run build:prod |
| Run PHP tests | npm run test:php |
| Run PHP checks | composer phpcs && composer phpstan |