PHPackages ralfhortt/wordpress-theme-boilerplate - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. ralfhortt/wordpress-theme-boilerplate ActiveWordpress-theme[Utility & Helpers](/categories/utility) ralfhortt/wordpress-theme-boilerplate ===================================== A WordPress Boilerplate Theme by Ralf Hortt 3314[7 PRs](https://github.com/Horttcore/WordPress-Theme-Boilerplate/pulls)PHPCI failing Since Nov 5Pushed 1mo ago1 watchersCompare [ Source](https://github.com/Horttcore/WordPress-Theme-Boilerplate)[ Packagist](https://packagist.org/packages/ralfhortt/wordpress-theme-boilerplate)[ RSS](/packages/ralfhortt-wordpress-theme-boilerplate/feed)WikiDiscussions master Synced 4w ago READMEChangelogDependenciesVersions (11)Used By (0) WordPress Theme Boilerplate =========================== [](#wordpress-theme-boilerplate) [![WordPress](https://camo.githubusercontent.com/3113e6880bc8a9c3d262fec6ba4f09345c288e4e8a583a6112b092641f6c76b5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f576f726450726573732d362e382b2d3231373539423f7374796c653d666f722d7468652d6261646765266c6f676f3d776f72647072657373266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/3113e6880bc8a9c3d262fec6ba4f09345c288e4e8a583a6112b092641f6c76b5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f576f726450726573732d362e382b2d3231373539423f7374796c653d666f722d7468652d6261646765266c6f676f3d776f72647072657373266c6f676f436f6c6f723d7768697465) [![PHP](https://camo.githubusercontent.com/79b971ffbad852b1b665c8bcc8fa932b272bf356935237560f733fb071033570/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342b2d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/79b971ffbad852b1b665c8bcc8fa932b272bf356935237560f733fb071033570/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342b2d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870266c6f676f436f6c6f723d7768697465) [![Node](https://camo.githubusercontent.com/8e0ed4a3cba39c7afe7e3f55a46a364474d070b41e4201e5eefdd807f61c116c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4e6f64652d32322e31312b2d3333393933333f7374796c653d666f722d7468652d6261646765266c6f676f3d6e6f64652e6a73266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/8e0ed4a3cba39c7afe7e3f55a46a364474d070b41e4201e5eefdd807f61c116c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4e6f64652d32322e31312b2d3333393933333f7374796c653d666f722d7468652d6261646765266c6f676f3d6e6f64652e6a73266c6f676f436f6c6f723d7768697465) [![TypeScript 5.9.3](https://camo.githubusercontent.com/8b7de149b71e58e7e70484ddec7969908cb7161ac99ddbbef558112c6838a107/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e392e332d3331373843363f7374796c653d666f722d7468652d6261646765266c6f676f3d74797065736372697074266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/8b7de149b71e58e7e70484ddec7969908cb7161ac99ddbbef558112c6838a107/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e392e332d3331373843363f7374796c653d666f722d7468652d6261646765266c6f676f3d74797065736372697074266c6f676f436f6c6f723d7768697465) [![Rector v2.2.9](https://camo.githubusercontent.com/ac52c5db46793068693f9454e967cb78d8537f5603cfc0790fb3cc9278755633/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f526563746f722d76322e322e392d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/ac52c5db46793068693f9454e967cb78d8537f5603cfc0790fb3cc9278755633/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f526563746f722d76322e322e392d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870266c6f676f436f6c6f723d7768697465) [![License](https://camo.githubusercontent.com/6e2148923f7b0f51e83954c648417c36a58065c5e6db384f025a87c3bba40b84/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c2d2d322e302b2d626c75653f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/6e2148923f7b0f51e83954c648417c36a58065c5e6db384f025a87c3bba40b84/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c2d2d322e302b2d626c75653f7374796c653d666f722d7468652d6261646765) --- 🛠️ Technologies --------------- [](#️-technologies) **Frontend** - [![SCSS](https://camo.githubusercontent.com/e13d697d086c965f94dde356834495653259434856049abca41626fcb8e38cf1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f534353532d4343363639393f7374796c653d666c61742d737175617265266c6f676f3d73617373266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/e13d697d086c965f94dde356834495653259434856049abca41626fcb8e38cf1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f534353532d4343363639393f7374796c653d666c61742d737175617265266c6f676f3d73617373266c6f676f436f6c6f723d7768697465) - [![TypeScript](https://camo.githubusercontent.com/e6bc1b669fe5e0006c51b579cbaff8c7cad53e00fdbc4eeab90b19076a201a5d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d3331373843363f7374796c653d666c61742d737175617265266c6f676f3d74797065736372697074266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/e6bc1b669fe5e0006c51b579cbaff8c7cad53e00fdbc4eeab90b19076a201a5d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d3331373843363f7374796c653d666c61742d737175617265266c6f676f3d74797065736372697074266c6f676f436f6c6f723d7768697465) **Build Tools** - [![WordPress](https://camo.githubusercontent.com/0f5c55dae4c943f60f208fb5a8ef47d06811d0abb62425220b0f13799dd82d48/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f40776f726470726573732f736372697074732d3231373539423f7374796c653d666c61742d737175617265266c6f676f3d776f72647072657373266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/0f5c55dae4c943f60f208fb5a8ef47d06811d0abb62425220b0f13799dd82d48/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f40776f726470726573732f736372697074732d3231373539423f7374796c653d666c61742d737175617265266c6f676f3d776f72647072657373266c6f676f436f6c6f723d7768697465) - [![Node.js](https://camo.githubusercontent.com/f6db27cb659b92a8cd7b20b984af6c920eebc8e81eb5d63fa2f855ef1c535ca6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4e6f64652e6a732d3333393933333f7374796c653d666c61742d737175617265266c6f676f3d6e6f64652e6a73266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/f6db27cb659b92a8cd7b20b984af6c920eebc8e81eb5d63fa2f855ef1c535ca6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4e6f64652e6a732d3333393933333f7374796c653d666c61742d737175617265266c6f676f3d6e6f64652e6a73266c6f676f436f6c6f723d7768697465) **Code Quality** - [![PHPStan](https://camo.githubusercontent.com/b5e6bbd6d7a07d4ea9e53dadae913251c24780948f1b314b68aefb27c302f8d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/b5e6bbd6d7a07d4ea9e53dadae913251c24780948f1b314b68aefb27c302f8d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465) - [![Rector](https://camo.githubusercontent.com/e3c2ed7eed3e4bfa5ce8479b2318d1132a479c0a66b201a5756177713111cb0b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f526563746f722d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/e3c2ed7eed3e4bfa5ce8479b2318d1132a479c0a66b201a5756177713111cb0b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f526563746f722d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465) - [![Stylelint](https://camo.githubusercontent.com/c3bea8cad8717396c2685c8c9ef574951994a9fddf348b497be4d1dfe41bf269/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5374796c656c696e742d3236333233383f7374796c653d666c61742d737175617265266c6f676f3d7374796c656c696e74266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/c3bea8cad8717396c2685c8c9ef574951994a9fddf348b497be4d1dfe41bf269/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5374796c656c696e742d3236333233383f7374796c653d666c61742d737175617265266c6f676f3d7374796c656c696e74266c6f676f436f6c6f723d7768697465) - [![Pint](https://camo.githubusercontent.com/a8db64fb1e6f20bf28ba860258c6417d5cd64bcefc170b08996ae798f3e6c4e6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50696e742d4646324432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/a8db64fb1e6f20bf28ba860258c6417d5cd64bcefc170b08996ae798f3e6c4e6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50696e742d4646324432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465) --- --- 📚 Documentation --------------- [](#-documentation) - [INSTALLATION.md](INSTALLATION.md): setup and requirements - [DEPENDENCIES.md](DEPENDENCIES.md): dependency overview - [CHANGELOG.md](CHANGELOG.md): release history - [.github/agents/THEME-HOW-IT-WORKS.md](.github/agents/THEME-HOW-IT-WORKS.md): high-level theme architecture - [.github/agents/THEME-JSON-WORKFLOW.md](.github/agents/THEME-JSON-WORKFLOW.md): TypeScript theme.json workflow - [.github/agents/THEME\_AUTOCOMPLETION.md](.github/agents/THEME_AUTOCOMPLETION.md): preset and custom property autocomplete system --- 🚀 Installation -------------- [](#-installation) ``` composer create-project ralfhortt/wordpress-theme-boilerplate ``` For detailed setup, see [INSTALLATION.md](INSTALLATION.md). --- 💻 Development ------------- [](#-development) ### Quick Start [](#quick-start) ``` npm start ``` Starts development watchers for assets, blocks, block styles, and theme configuration. ``` npm run build ``` Runs a production build for assets, blocks, and generated theme files. ### Main Commands [](#main-commands) #### Build and Watch [](#build-and-watch) CommandDescription`npm run build`Full production build`npm start`Start all development watchers`npm run build:theme`Build root theme.json from TypeScript config`npm run watch:theme`Watch TypeScript config and rebuild theme.json`npm run generate:theme-types`Refresh schema-derived theme TypeScript types#### Scaffolding and Helpers [](#scaffolding-and-helpers) CommandDescription`npm run make:block`Scaffold a new block`npm run make:block-config`Scaffold a TypeScript block config file`npm run make:block-style`Scaffold a block style variation config`npm run make:pattern`Scaffold a pattern file`npm run css:clamp`CSS clamp helper`npm run css:color`Color conversion helper`npm run css:contrast`Contrast helper#### Linting and Formatting [](#linting-and-formatting) CommandDescription`npm run lint`Run Stylelint and PHP lint checks`npm run lint:css`Run Stylelint for SCSS`npm run lint:css:fix`Auto-fix Stylelint issues`npm run lint:php`Run PHP lint via Composer scripts`composer run lint:php`Run PHPStan analysis`composer run format`Format PHP with Pint`composer run refactor`Apply Rector refactors`composer run refactor:dry`Preview Rector refactors### Commit Workflow [](#commit-workflow) This repository enforces commit quality checks through Husky hooks: - Pre-commit: runs Rector and Pint on staged PHP files, then lint checks. - Commit-msg: enforces Conventional Commits format. Example commit messages: - `feat: add starter pattern scaffold` - `fix: handle empty post type input` - `chore: update lint tooling` --- 🏗️ Theme Architecture --------------------- [](#️-theme-architecture) The project uses a TypeScript-first workflow for theme configuration. ### Source of Truth [](#source-of-truth) - `src/blocks/theme.ts`: base theme configuration - `src/blocks/core/`: per-core-block config modules - `theme.json`: generated output consumed by WordPress ### Build Flow [](#build-flow) 1. Edit files in `src/blocks/`. 2. Run `npm run build:theme` or `npm run build`. 3. Commit source changes and generated outputs as needed by your workflow. For full details, see [.github/agents/THEME-JSON-WORKFLOW.md](.github/agents/THEME-JSON-WORKFLOW.md). ### Health Score 34 — LowBetter than 74% of packages Maintenance61 Regular maintenance activity Popularity13 Limited adoption so far Community11 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 97.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/45d54752dcf3da868ffe4a5ad2b876d6acb911fd914700b52e4d4777ff7d4a02?d=identicon)[Ralf Hortt](/maintainers/Ralf%20Hortt) --- Top Contributors [![Horttcore](https://avatars.githubusercontent.com/u/503252?v=4)](https://github.com/Horttcore "Horttcore (346 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)") --- Tags boilerplateboilerplate-templatethemewordpress ### Embed Badge ![Health badge](/badges/ralfhortt-wordpress-theme-boilerplate/health.svg) ``` [![Health](https://phpackages.com/badges/ralfhortt-wordpress-theme-boilerplate/health.svg)](https://phpackages.com/packages/ralfhortt-wordpress-theme-boilerplate) ``` ### Alternatives [enqueue/dsn Parse DSN 12627.0M66](/packages/enqueue-dsn)[shockwavemk/magento2-module-cron-schedule Show advanced information for scheduled crons in Magento2 Backend 3434.0k](/packages/shockwavemk-magento2-module-cron-schedule) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)