PHPackages charliefishtank/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. charliefishtank/sage ActiveWordpress-theme[Utility & Helpers](/categories/utility) charliefishtank/sage ==================== WordPress starter theme with a modern development workflow 9.0.10(5y ago)022[19 PRs](https://github.com/charliefishtank/sage/pulls)MITPHPPHP >=7.1 Since Jan 27Pushed 3y agoCompare [ Source](https://github.com/charliefishtank/sage)[ Packagist](https://packagist.org/packages/charliefishtank/sage)[ Docs](https://roots.io/sage/)[ RSS](/packages/charliefishtank-sage/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (6)Versions (66)Used By (0) [ ![Sage](https://camo.githubusercontent.com/f3039fe60f1c614e8b28dbb9f666f090db0b6fc76e94c5f7f0bd5c7da394d80a/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6c6f676f2d736167652e737667) ](https://roots.io/sage/) [ ![MIT License](https://camo.githubusercontent.com/374d603d8f67b11056676623748bdce6b755f3869b1ed30e6f74fd73f25556ee/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f726f6f74732f736167653f636f6c6f723d253233353235646463267374796c653d666c61742d737175617265) ](LICENSE.md) [ ![Packagist](https://camo.githubusercontent.com/0146b25c2fc6289960cbbdb3b95ae4d7af66c5ed3206bea9a708ec94f614a48f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726f6f74732f736167652e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/roots/sage) [ ![Build Status](https://camo.githubusercontent.com/21bac5be4cfd79a8cdd94cd9729c4a6a0b8016d6ade35ee1c5cf9c4f615508bb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f726f6f74732f736167652f4d61696e3f7374796c653d666c61742d737175617265) ](https://github.com/roots/sage/actions) [ ![Follow Roots](https://camo.githubusercontent.com/2b8273856233cb73467f46b7b730c721f9b4d3b1751394e4127246f862720f34/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f726f6f747377702e7376673f7374796c653d666c61742d73717561726526636f6c6f723d316461316632) ](https://twitter.com/rootswp) **WordPress starter theme with a modern development workflow** Built with ❤️ [Official Website](https://roots.io) | [Documentation](https://docs.roots.io/sage/10.x/installation/) | [Change Log](CHANGELOG.md) Supporting ---------- [](#supporting) **Sage** is an open source project and completely free to use. However, the amount of effort needed to maintain and develop new features and products within the Roots ecosystem is not sustainable without proper financial backing. If you have the capability, please consider donating using the links below: [![Sponsor on GitHub](https://camo.githubusercontent.com/a7fd8eae29990afcc8b19b3889ebe2964e2e31f2ebb8da1c384e88541f9a64a8/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d73706f6e736f72266d6573736167653d254532253944254134266c6f676f3d476974487562)](https://github.com/sponsors/roots)[![Sponsor on Patreon](https://camo.githubusercontent.com/eeec539a157e6d25798e763cb42e9fc20b27a86551c9dad5b5ee743749db21f6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73706f6e736f722d70617472656f6e2d6f72616e67652e7376673f7374796c653d666c61742d737175617265266c6f676f3d70617472656f6e253232)](https://www.patreon.com/rootsdev)[![Donate via PayPal](https://camo.githubusercontent.com/e9dbfb6fa3fe88e12cc4e9af4cbafffb9b6cd116e78dd0d917f051f947618a8c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d70617970616c2d626c75652e7376673f7374796c653d666c61742d737175617265266c6f676f3d70617970616c)](https://www.paypal.me/rootsdev) About Sage ---------- [](#about-sage) Sage is a productivity-driven WordPress starter theme with a modern development workflow. **The `main` branch currently tracks Sage 10 which is in active development. Looking for Sage 9 or the latest Sage 10 beta release? [See releases](https://github.com/roots/sage/releases).** Features -------- [](#features) - Harness the power of [Laravel](https://laravel.com) and its available packages thanks to [Acorn](https://github.com/roots/acorn). - Clean, efficient theme templating utilizing [Laravel Blade](https://laravel.com/docs/master/blade). - Lightning fast frontend development workflow powered by [Bud](https://budjs.netlify.app/). - Out of the box support for [TailwindCSS](https://tailwindcss.com/). Requirements ------------ [](#requirements) Make sure all dependencies have been installed before moving on: - [WordPress](https://wordpress.org/) >= 5.4 - [PHP](https://secure.php.net/manual/en/install.php) >= 7.3.0 (with [`php-mbstring`](https://secure.php.net/manual/en/book.mbstring.php) enabled) - [Composer](https://getcomposer.org/download/) - [Node.js](http://nodejs.org/) >= 16 - [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-main` to the end of the command: ``` $ composer create-project roots/sage your-theme-name dev-main ``` Theme structure --------------- [](#theme-structure) ``` themes/your-theme-name/ # → Root of your Sage based theme ├── app/ # → Theme PHP │ ├── Providers/ # → Service providers │ ├── View/ # → View models │ ├── admin.php # → Theme customizer setup │ ├── filters.php # → Theme filters │ ├── helpers.php # → Helper functions │ └── setup.php # → Theme setup ├── bootstrap/ # → Acorn bootstrap │ ├── cache/ # → Acorn cache location (never edit) │ └── app.php # → Acorn application bootloader ├── config/ # → Config files │ ├── app.php # → Application configuration │ ├── assets.php # → Asset configuration │ ├── filesystems.php # → Filesystems configuration │ ├── logging.php # → Logging configuration │ └── view.php # → View configuration ├── composer.json # → Autoloading for `app/` files ├── composer.lock # → Composer lock file (never edit) ├── public/ # → Built theme assets (never edit) ├── functions.php # → Theme bootloader ├── index.php # → Theme template wrapper ├── node_modules/ # → Node.js packages (never edit) ├── package.json # → Node.js dependencies and scripts ├── resources/ # → Theme assets and templates │ ├── fonts/ # → Theme fonts │ ├── images/ # → Theme images │ ├── scripts/ # → Theme javascript │ ├── styles/ # → Theme stylesheets │ └── views/ # → Theme templates │ ├── components/ # → Component templates │ ├── forms/ # → Form templates │ ├── layouts/ # → Base templates │ └── partials/ # → Partial templates ├── screenshot.png # → Theme screenshot for WP admin ├── storage/ # → Storage location for cache (never edit) ├── style.css # → Theme meta information ├── vendor/ # → Composer packages (never edit) └── bud.config.js # → Bud configuration ``` 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 `bud.config.js` with your local dev URL ### Build commands [](#build-commands) - `yarn dev` — Compile assets when file changes are made, start Browsersync session - `yarn build` — Compile assets for production Documentation ------------- [](#documentation) - [Sage documentation](https://docs.roots.io/sage/10.x/installation/) 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. Sage sponsors ------------- [](#sage-sponsors) Help support our open-source development efforts by [becoming a sponsor](https://github.com/sponsors/roots). [![Kinsta](https://camo.githubusercontent.com/efddc19d1bac22ad7023a1590d7fd98658a3abc0a6d5e3ac01f7927b02b3d1f2/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6b696e7374612e737667)](https://kinsta.com/?kaid=OFDHAJIXUDIV) [![KM Digital](https://camo.githubusercontent.com/a43c3d99df2424b5db9767c5c1af52bcebc5ce3685ede00f8472bcb1e4dd7792/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6b6d2d6469676974616c2e737667)](https://k-m.com/) [![Carrot](https://camo.githubusercontent.com/a65d309f3418223caa092f5ed2aa85ff2fed82a001b56f4c9f396891c6c7152c/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f636172726f742e737667)](https://carrot.com/) [![C21 Redwood Realty](https://camo.githubusercontent.com/1ff89c28a54867bc095487baa5d392b019b643307c27831a68a1a0b1c006a40b/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f633231726564776f6f642e737667)](https://www.c21redwood.com/) [![WordPress.com](https://camo.githubusercontent.com/4daf2fea17fd7850dc12840a19cca8ece900f7eafcf8abb1e7c5dab08635fb6c/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f776f726470726573732e737667)](https://wordpress.com/) [![Icons8](https://camo.githubusercontent.com/adb2a5225d1c5c6dc1bdf1d1483335cdc313dfd60c180a79655871251fa3143f/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f69636f6e73382e737667)](https://icons8.com/) [![Harness Software](https://camo.githubusercontent.com/1f13b63e6e47e52558dbfa67fca7fb628b0205ffcb9cff532870f311296b2487/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6861726e6573732d736f6674776172652e737667)](https://www.harnessup.com/) [![Airfleet](https://camo.githubusercontent.com/d6392558264f512517ef4399cd55346348859daca3fec238fa1609d78f15a8aa/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f616972666c6565742e737667)](https://www.airfleet.co/careers?utm_source=roots&utm_content=sage-page) [![Genero](https://camo.githubusercontent.com/2ef546febe866579158db117b9e46c0fa169d84dae0decc4a248eb34f25a4451/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f67656e65726f2e737667)](https://generodigital.com/) [![40Q](https://camo.githubusercontent.com/8eec04b760042551920214d6fab1a3b605c6985269fe6d7c60f7e0d0ba76d3d4/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f3430712e737667)](https://40q.agency/) [![Pantheon](https://camo.githubusercontent.com/a627fb1c1f4f21a19bfa9ac8acff1617f6bf2c38d21dbb65a36d02923a951691/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f70616e7468656f6e2e737667)](https://pantheon.io/) 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 Popularity6 Limited adoption so far Community19 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 61.4% 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 ~61 days Recently: every ~0 days Total 36 Last Release 1600d ago Major Versions 9.0.10 → 10.0.0-beta.12021-10-21 v1.0.1 → 10.0.0-beta.22021-12-21 v1.0.2 → v2.0.02021-12-23 v2.0.0.x-dev → v3.0.02021-12-24 v3.0.0 → 9.x-dev2021-12-24 PHP version history (6 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.1PHP >=7.1 10.0.0-beta.1PHP ^7.3|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/734f4d25e54aa6dd3f1155bb2e21b9ae024e78c8334cb709eeddf90d6fe83194?d=identicon)[CharlieFishtank](/maintainers/CharlieFishtank) --- Top Contributors [![retlehs](https://avatars.githubusercontent.com/u/115911?v=4)](https://github.com/retlehs "retlehs (1265 commits)")[![swalkinshaw](https://avatars.githubusercontent.com/u/295605?v=4)](https://github.com/swalkinshaw "swalkinshaw (218 commits)")[![QWp6t](https://avatars.githubusercontent.com/u/2104321?v=4)](https://github.com/QWp6t "QWp6t (170 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)")[![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (38 commits)")[![kalenjohnson](https://avatars.githubusercontent.com/u/2036520?v=4)](https://github.com/kalenjohnson "kalenjohnson (24 commits)")[![weslly](https://avatars.githubusercontent.com/u/107672?v=4)](https://github.com/weslly "weslly (18 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 commits)")[![MWDelaney](https://avatars.githubusercontent.com/u/2457670?v=4)](https://github.com/MWDelaney "MWDelaney (15 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)")[![knowler](https://avatars.githubusercontent.com/u/6908001?v=4)](https://github.com/knowler "knowler (14 commits)")[![leoj3n](https://avatars.githubusercontent.com/u/990216?v=4)](https://github.com/leoj3n "leoj3n (12 commits)")[![cfxd](https://avatars.githubusercontent.com/u/1671933?v=4)](https://github.com/cfxd "cfxd (12 commits)")[![mmirus](https://avatars.githubusercontent.com/u/524994?v=4)](https://github.com/mmirus "mmirus (9 commits)")[![davekiss](https://avatars.githubusercontent.com/u/1256071?v=4)](https://github.com/davekiss "davekiss (8 commits)")[![lautreamont3](https://avatars.githubusercontent.com/u/4511349?v=4)](https://github.com/lautreamont3 "lautreamont3 (7 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (7 commits)")[![alwaysblank](https://avatars.githubusercontent.com/u/23412884?v=4)](https://github.com/alwaysblank "alwaysblank (7 commits)") --- Tags wordpress ### Code Quality Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/charliefishtank-sage/health.svg) ``` [![Health](https://phpackages.com/badges/charliefishtank-sage/health.svg)](https://phpackages.com/packages/charliefishtank-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)