PHPackages tonik/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. tonik/wordpress-theme-boilerplate AbandonedArchivedWordpress-theme[Utility & Helpers](/categories/utility) tonik/wordpress-theme-boilerplate ================================= A modern WordPress boilerplate for building organized and standardized themes 571719[3 issues](https://github.com/tonik/wordpress-theme-boilerplate/issues)[1 PRs](https://github.com/tonik/wordpress-theme-boilerplate/pulls)PHP Since Sep 12Pushed 5y ago2 watchersCompare [ Source](https://github.com/tonik/wordpress-theme-boilerplate)[ Packagist](https://packagist.org/packages/tonik/wordpress-theme-boilerplate)[ RSS](/packages/tonik-wordpress-theme-boilerplate/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (1)Used By (0) Tonik — Wordpress Theme Boilerplate =================================== [](#tonik--wordpress-theme-boilerplate) > The `develop` branch tracks boilerplate development and it's not a stable code. If you want a stable version, use the [`master`](//github.com/tonik/wordpress-theme-boilerplate/tree/master) branch or one of the latest [releases](//github.com/tonik/wordpress-theme-boilerplate/releases). ### Boilerplate aims to be compatible with a large range of PHP versions, however, still have modern tooling for developing a theme. [](#boilerplate-aims-to-be-compatible-with-a-large-range-of-php-versions-however-still-have-modern-tooling-for-developing-a-theme) What's inside? - [Gulp](//gulpjs.com/) - Task runner - [SASS](//sass-lang.com/) - a CSS preprocessor - [Babel](//babeljs.io/) - JavaScript ES6 to ES5 compiler - [Rollup](//rollupjs.org/) - a JavaScript Modules Bundler - [Stylelint](//stylelint.io/) - a SCSS linter - [ESLint](//eslint.org/) - a JavaScript linter - [PHP\_CodeSniffer](//github.com/squizlabs/PHP_CodeSniffer) - a PHP sniffer The front-end builder was borrowed from our [html-frontend-boilerplate](https://github.com/tonik/html-frontend-boilerplate) project. ### Requirements [](#requirements) Boilerplate follows a [WordPress minimal requirements](https://wordpress.org/about/requirements/). Make sure you have these dependences installed before moving on: - PHP >= 5.2.4 Theme uses [NPM](//www.npmjs.com/) as a front-end dependency manager. Make sure your development machine has installed following dependencies: - [Node.js](//nodejs.org/) - [NPM](//www.npmjs.com/) Installation ------------ [](#installation) WordPress themes lives in the `wp-content/themes` folder. This is where we have to fetch our fresh starter files. ``` # Go to the `themes` directory of your WordPress installation. $ cd wp-content/themes ``` Create project via `composer create-project` composer command. ``` $ composer create-project tonik/wordpress-theme-boilerplate ``` You can also directly download or clone the repository to the `wp-content/themes` directory. ``` # Clone repository to the folder. $ git clone -b master git@github.com:tonik/wordpress-theme-boilerplate.git ``` Development ----------- [](#development) A [Gulp](https://gulpjs.com/) task runner is used to compile and optimize theme's scripts, stylesheets, and images. #### Resolving front-end dependencies [](#resolving-front-end-dependencies) Before being able to build theme you have to resolve required dependencies. ``` # @ wp-content/themes/ # Install node dependencies. $ npm install ``` Now you have all the packages necessary to run the build process and start developing your theme. #### Building a Theme [](#building-a-theme) There are a few available commands which help you to build the theme for different environments: ``` # @ wp-content/themes/ # Compiles unminified and unoptimized theme assets with source maps. $ npm run development # Alias for `development` command. $ npm run dev # Compiles minified and optimized theme assets without source maps. $ npm run production # Alias for `production` command. $ npm run prod # Builds assets for development, runs watcher (recompiles on change) # and BroswerSync (refreshes browser). $ npm run watch ``` Contributing ------------ [](#contributing) Great that you are considering supporting the project. You have a lot of ways to help us grow. We appreciate all contributions, even the smallest. - Report an issue - Propose a feature - Send a pull request - Star project on the [GitHub](https://github.com/tonik/wordpress-theme-boilerplate) - Tell about project around your community License ------- [](#license) The Tonik WordPress Theme Boilerplate is licensed under the [MIT license](http://opensource.org/licenses/MIT). ### Health Score 25 — LowBetter than 36% of packages Maintenance19 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community15 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 75.9% 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/e57986d4f1265aa000ed0fce6d2a86b5eb64ac930029e437dd8fb19c54ffbe20?d=identicon)[GrzegorzRybkowski](/maintainers/GrzegorzRybkowski) --- Top Contributors [![jedrzejchalubek](https://avatars.githubusercontent.com/u/3652932?v=4)](https://github.com/jedrzejchalubek "jedrzejchalubek (22 commits)")[![rybkowskigrzegorz](https://avatars.githubusercontent.com/u/13903291?v=4)](https://github.com/rybkowskigrzegorz "rybkowskigrzegorz (7 commits)") --- Tags wordpresswordpress-developmentwordpress-starter-themewordpress-theme ### Embed Badge ![Health badge](/badges/tonik-wordpress-theme-boilerplate/health.svg) ``` [![Health](https://phpackages.com/badges/tonik-wordpress-theme-boilerplate/health.svg)](https://phpackages.com/packages/tonik-wordpress-theme-boilerplate) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)