PHPackages                             itcig/sage-timber - 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. [Framework](/categories/framework)
4. /
5. itcig/sage-timber

ActiveWordpress-theme[Framework](/categories/framework)

itcig/sage-timber
=================

WordPress starter theme with a modern development workflow modified to work with Timber

v9.1.0(6y ago)012[8 PRs](https://github.com/itcig/sage-9-timber/pulls)MITPHPPHP &gt;=7

Since Jan 27Pushed 2y ago2 watchersCompare

[ Source](https://github.com/itcig/sage-9-timber)[ Packagist](https://packagist.org/packages/itcig/sage-timber)[ Docs](https://github.com/itcig/)[ RSS](/packages/itcig-sage-timber/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (2)Dependencies (6)Versions (39)Used By (0)

Sage-9-Timber
=============

[](#sage-9-timber)

Sage-9-Timber is [Sage theme](https://github.com/roots/sage) version 9 made to work with [Timber](https://www.upstatement.com/timber/).

For easy integrations and later compatibility, this repository aimed at making the minimum of changes possible to the original Sage 9 beta 4 in order to make Timber work. This theme has still twig template language support.

**Sage 9 is in active development and is currently in beta. This initial fork used version Sage 9 beta 4. If you want a stable version of Sage ported to Timber, have a look at the [sage-timber](https://github.com/itcig/sage-timber) project.**

Bedrock specific Install
------------------------

[](#bedrock-specific-install)

You must implement the following in the root of the Bedrock project composer.json. Otherwise your controllers will not be loaded by the SageController package since it will be expecting them to load relative to the theme composer autoloader.

```
"autoload": {
    "psr-4": {
        "App\\": "web/app/themes//app/"
    }
},

```

Features
--------

[](#features)

- Sass for stylesheets
- ES6 for 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
- [Twig](https://twig.symfony.com/doc/2.x/) as a templating engine
- [Controller](https://github.com/soberwp/controller) for passing data to Blade templates
- CSS framework options:
    - [Bootstrap 4](http://getbootstrap.com/)
    - [Bulma](http://bulma.io/)
    - [Foundation](http://foundation.zurb.com/)
    - [Tachyons](http://tachyons.io/)
    - None (blank slate)
- Font Awesome (optional)

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:

- [Timber](https://www.upstatement.com/timber/) as a WordPress plugin
- [WordPress](https://wordpress.org/) &gt;= 4.7
- [PHP](http://php.net/manual/en/install.php) &gt;= 7.0
- [Composer](https://getcomposer.org/download/)
- [Node.js](http://nodejs.org/) &gt;= 6.9.x
- [Yarn](https://yarnpkg.com/en/docs/install)

Theme installation
------------------

[](#theme-installation)

Install Sage-9-timber by copying the project into a new folder within your WordPress themes directory.

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         # → Actions and theme options
│   └── timber.php        # → Timber init
├── 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 Timber templates
│       └── templates/    # → Timber twig 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 run start` — Compile assets when file changes are made, start Browsersync session
- `yarn run build` — Compile and optimize the files in your assets directory
- `yarn run build:production` — Compile assets for production

Documentation
-------------

[](#documentation)

Timber documentation is available at .

Twig documentation is available at .

Sage 9 documentation is currently in progress and can be viewed at .

Controller documentation is available at .

Contributing
------------

[](#contributing)

Contributions are welcome from everyone. Just issue a pull request to this repository.

Sage Community
--------------

[](#sage-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

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 62.3% 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 ~69 days

Recently: every ~142 days

Total

23

Last Release

2283d 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 → 9.0.02018-02-07

8.5.4 → 9.0.12018-04-30

PHP version history (5 changes)8.4.1PHP &gt;=5.4.0

9.0.0-alpha.1PHP &gt;=5.5.0

9.0.0-beta.1PHP &gt;=5.6.4

9.0.0-beta.4PHP &gt;=7

9.0.1PHP &gt;=7.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1675787?v=4)[Capitol Information Group](/maintainers/itcig)[@itcig](https://github.com/itcig)

---

Top Contributors

[![retlehs](https://avatars.githubusercontent.com/u/115911?v=4)](https://github.com/retlehs "retlehs (1213 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)")[![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)")[![MWDelaney](https://avatars.githubusercontent.com/u/2457670?v=4)](https://github.com/MWDelaney "MWDelaney (14 commits)")[![coreywagehoft](https://avatars.githubusercontent.com/u/767849?v=4)](https://github.com/coreywagehoft "coreywagehoft (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)")[![unfrgivn](https://avatars.githubusercontent.com/u/1675472?v=4)](https://github.com/unfrgivn "unfrgivn (11 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)")[![knowler](https://avatars.githubusercontent.com/u/6908001?v=4)](https://github.com/knowler "knowler (7 commits)")[![mmirus](https://avatars.githubusercontent.com/u/524994?v=4)](https://github.com/mmirus "mmirus (7 commits)")[![alwaysblank](https://avatars.githubusercontent.com/u/23412884?v=4)](https://github.com/alwaysblank "alwaysblank (6 commits)")[![johnraz](https://avatars.githubusercontent.com/u/304164?v=4)](https://github.com/johnraz "johnraz (6 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/itcig-sage-timber/health.svg)

```
[![Health](https://phpackages.com/badges/itcig-sage-timber/health.svg)](https://phpackages.com/packages/itcig-sage-timber)
```

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

1.0k2.1M163](/packages/laravel-ai)[themosis/framework

The Themosis framework.

669311.6k18](/packages/themosis-framework)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45344.0k1](/packages/pressbooks-pressbooks)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)[pods-framework/pods

Pods is a development framework for creating, extending, managing, and deploying customized content types in WordPress.

1.1k1.7k](/packages/pods-framework-pods)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
