PHPackages mikevosje/sage - 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. mikevosje/sage ActiveWordpress-theme[Utility & Helpers](/categories/utility) mikevosje/sage ============== WordPress starter theme with a modern development workflow 9.0.30(7y ago)028MITPHPPHP >=7.1 Since Jan 27Pushed 7y agoCompare [ Source](https://github.com/mikevosje/sage)[ Packagist](https://packagist.org/packages/mikevosje/sage)[ Docs](https://roots.io/sage/)[ RSS](/packages/mikevosje-sage/feed)WikiDiscussions master Synced yesterday READMEChangelog (4)Dependencies (6)Versions (31)Used By (0) [Sage](https://roots.io/sage/) ============================== [](#sage) [![Packagist](https://camo.githubusercontent.com/7afb88963e32c987e719a00d7eb449a309a10bc3738a9e86ebe39ee1afd2504a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f767072652f726f6f74732f736167652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/roots/sage)[![devDependency Status](https://camo.githubusercontent.com/c5ff9b09c354d0ade0550398ca3a2448d12616206cf246562b6ec747588164db/68747470733a2f2f696d672e736869656c64732e696f2f64617669642f6465762f726f6f74732f736167652e7376673f7374796c653d666c61742d737175617265)](https://david-dm.org/roots/sage#info=devDependencies)[![Build Status](https://camo.githubusercontent.com/b412cab2de7df7f0e0dc4d83a0f66f5797ad1d06016565aebb78325f7e9f3116/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f726f6f74732f736167652e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/roots/sage) Sage is a WordPress starter theme with a modern development workflow. Features -------- [](#features) - Sass for stylesheets - Modern JavaScript - [Webpack](https://webpack.github.io/) for compiling assets, optimizing images, and concatenating and minifying files - [Browsersync](http://www.browsersync.io/) for synchronized browser testing - [Blade](https://laravel.com/docs/5.5/blade) as a templating engine - [Controller](https://github.com/soberwp/controller) for passing data to Blade templates - CSS framework (optional): [Bootstrap 4](https://getbootstrap.com/), [Bulma](https://bulma.io/), [Foundation](https://foundation.zurb.com/), [Tachyons](http://tachyons.io/) See a working example at [roots-example-project.com](https://roots-example-project.com/). Requirements ------------ [](#requirements) Make sure all dependencies have been installed before moving on: - [WordPress](https://wordpress.org/) >= 4.7 - [PHP](https://secure.php.net/manual/en/install.php) >= 7.1.3 (with [`php-mbstring`](https://secure.php.net/manual/en/book.mbstring.php) enabled) - [Composer](https://getcomposer.org/download/) - [Node.js](http://nodejs.org/) >= 6.9.x - [Yarn](https://yarnpkg.com/en/docs/install) Theme installation ------------------ [](#theme-installation) Install Sage using Composer from your WordPress themes directory (replace `your-theme-name` below with the name of your theme): ``` # @ app/themes/ or wp-content/themes/ $ composer create-project roots/sage your-theme-name ``` To install the latest development version of Sage, add `dev-master` to the end of the command: ``` $ composer create-project roots/sage your-theme-name dev-master ``` During theme installation you will have options to update `style.css` theme headers, select a CSS framework, and configure Browsersync. Theme structure --------------- [](#theme-structure) ``` themes/your-theme-name/ # → Root of your Sage based theme ├── app/ # → Theme PHP │ ├── controllers/ # → Controller files │ ├── admin.php # → Theme customizer setup │ ├── filters.php # → Theme filters │ ├── helpers.php # → Helper functions │ └── setup.php # → Theme setup ├── composer.json # → Autoloading for `app/` files ├── composer.lock # → Composer lock file (never edit) ├── dist/ # → Built theme assets (never edit) ├── node_modules/ # → Node.js packages (never edit) ├── package.json # → Node.js dependencies and scripts ├── resources/ # → Theme assets and templates │ ├── assets/ # → Front-end assets │ │ ├── config.json # → Settings for compiled assets │ │ ├── build/ # → Webpack and ESLint config │ │ ├── fonts/ # → Theme fonts │ │ ├── images/ # → Theme images │ │ ├── scripts/ # → Theme JS │ │ └── styles/ # → Theme stylesheets │ ├── functions.php # → Composer autoloader, theme includes │ ├── index.php # → Never manually edit │ ├── screenshot.png # → Theme screenshot for WP admin │ ├── style.css # → Theme meta information │ └── views/ # → Theme templates │ ├── layouts/ # → Base templates │ └── partials/ # → Partial templates └── vendor/ # → Composer packages (never edit) ``` Theme setup ----------- [](#theme-setup) Edit `app/setup.php` to enable or disable theme features, setup navigation menus, post thumbnail sizes, and sidebars. Theme development ----------------- [](#theme-development) - Run `yarn` from the theme directory to install dependencies - Update `resources/assets/config.json` settings: - `devUrl` should reflect your local development hostname - `publicPath` should reflect your WordPress folder structure (`/wp-content/themes/sage` for non-[Bedrock](https://roots.io/bedrock/) installs) ### Build commands [](#build-commands) - `yarn start` — Compile assets when file changes are made, start Browsersync session - `yarn build` — Compile and optimize the files in your assets directory - `yarn build:production` — Compile assets for production Documentation ------------- [](#documentation) - [Sage documentation](https://roots.io/sage/docs/) - [Controller documentation](https://github.com/soberwp/controller#usage) Contributing ------------ [](#contributing) Contributions are welcome from everyone. We have [contributing guidelines](https://github.com/roots/guidelines/blob/master/CONTRIBUTING.md) to help you get started. Gold sponsors ------------- [](#gold-sponsors) Help support our open-source development efforts by [contributing to Sage on OpenCollective](https://opencollective.com/sage). [![Kinsta](https://camo.githubusercontent.com/656e951881b367cc8f88235ad5d4998a79b3a8d9fb6005cd444f295e7cf4beef/68747470733a2f2f726f6f74732e696f2f6170702f75706c6f6164732f6b696e7374612e737667)](https://kinsta.com/?kaid=OFDHAJIXUDIV) [![KM Digital](https://camo.githubusercontent.com/ac0c32c0066c41bdee3bc00c822cf8aaf4d5216d3355fd73ec649e1747035efb/68747470733a2f2f726f6f74732e696f2f6170702f75706c6f6164732f6b6d2d6469676974616c2e737667)](https://k-m.com/) Community --------- [](#community) Keep track of development and community news. - Participate on the [Roots Discourse](https://discourse.roots.io/) - Follow [@rootswp on Twitter](https://twitter.com/rootswp) - Read and subscribe to the [Roots Blog](https://roots.io/blog/) - Subscribe to the [Roots Newsletter](https://roots.io/subscribe/) - Listen to the [Roots Radio podcast](https://roots.io/podcast/) ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community19 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 61.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. ### Release Activity Cadence Every ~33 days Recently: every ~17 days Total 26 Last Release 2915d ago Major Versions 8.4.2 → 9.0.0-alpha.12016-08-30 8.5.0 → 9.0.0-alpha.42016-11-17 8.5.1 → 9.0.0-beta.32017-04-21 8.5.3.x-dev → 9.0.02018-02-07 PHP version history (5 changes)8.4.1PHP >=5.4.0 9.0.0-alpha.1PHP >=5.5.0 9.0.0-beta.1PHP >=5.6.4 9.0.0-beta.4PHP >=7 9.0.29PHP >=7.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/00c17a8e2f1784187d4dfe3ca6ab04c323e8fd3632aff2fa35f808d1911e83a9?d=identicon)[wappz](/maintainers/wappz) --- Top Contributors [![retlehs](https://avatars.githubusercontent.com/u/115911?v=4)](https://github.com/retlehs "retlehs (1175 commits)")[![swalkinshaw](https://avatars.githubusercontent.com/u/295605?v=4)](https://github.com/swalkinshaw "swalkinshaw (216 commits)")[![QWp6t](https://avatars.githubusercontent.com/u/2104321?v=4)](https://github.com/QWp6t "QWp6t (161 commits)")[![austinpray](https://avatars.githubusercontent.com/u/2192970?v=4)](https://github.com/austinpray "austinpray (94 commits)")[![Foxaii](https://avatars.githubusercontent.com/u/1690407?v=4)](https://github.com/Foxaii "Foxaii (48 commits)")[![kalenjohnson](https://avatars.githubusercontent.com/u/2036520?v=4)](https://github.com/kalenjohnson "kalenjohnson (24 commits)")[![mikevosje](https://avatars.githubusercontent.com/u/3897623?v=4)](https://github.com/mikevosje "mikevosje (20 commits)")[![weslly](https://avatars.githubusercontent.com/u/107672?v=4)](https://github.com/weslly "weslly (18 commits)")[![JulienMelissas](https://avatars.githubusercontent.com/u/2278221?v=4)](https://github.com/JulienMelissas "JulienMelissas (15 commits)")[![coreywagehoft](https://avatars.githubusercontent.com/u/767849?v=4)](https://github.com/coreywagehoft "coreywagehoft (14 commits)")[![cfxd](https://avatars.githubusercontent.com/u/1671933?v=4)](https://github.com/cfxd "cfxd (12 commits)")[![leoj3n](https://avatars.githubusercontent.com/u/990216?v=4)](https://github.com/leoj3n "leoj3n (12 commits)")[![davekiss](https://avatars.githubusercontent.com/u/1256071?v=4)](https://github.com/davekiss "davekiss (8 commits)")[![MWDelaney](https://avatars.githubusercontent.com/u/2457670?v=4)](https://github.com/MWDelaney "MWDelaney (8 commits)")[![lautreamont3](https://avatars.githubusercontent.com/u/4511349?v=4)](https://github.com/lautreamont3 "lautreamont3 (7 commits)")[![johnraz](https://avatars.githubusercontent.com/u/304164?v=4)](https://github.com/johnraz "johnraz (6 commits)")[![alwaysblank](https://avatars.githubusercontent.com/u/23412884?v=4)](https://github.com/alwaysblank "alwaysblank (5 commits)")[![dvregan](https://avatars.githubusercontent.com/u/1561385?v=4)](https://github.com/dvregan "dvregan (5 commits)")[![hariadi](https://avatars.githubusercontent.com/u/376635?v=4)](https://github.com/hariadi "hariadi (5 commits)")[![LeoColomb](https://avatars.githubusercontent.com/u/846943?v=4)](https://github.com/LeoColomb "LeoColomb (5 commits)") --- Tags wordpress ### Code Quality Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/mikevosje-sage/health.svg) ``` [![Health](https://phpackages.com/badges/mikevosje-sage/health.svg)](https://phpackages.com/packages/mikevosje-sage) ``` ### Alternatives [roots/bedrock WordPress boilerplate with Composer, easier configuration, and an improved folder structure 6.5k441.8k2](/packages/roots-bedrock) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)