PHPackages                             upstatement/timber-starter-theme - 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. [Templating &amp; Views](/categories/templating)
4. /
5. upstatement/timber-starter-theme

Abandoned → [timber/starter-theme](/?search=timber%2Fstarter-theme)Wordpress-theme[Templating &amp; Views](/categories/templating)

upstatement/timber-starter-theme
================================

Starter theme to build a Timber theme

2.0.0(2y ago)8407.5k269[7 issues](https://github.com/Upstatement/timber-starter-theme/issues)[3 PRs](https://github.com/Upstatement/timber-starter-theme/pulls)MITTwigCI passing

Since May 28Pushed 2mo ago42 watchersCompare

[ Source](https://github.com/Upstatement/timber-starter-theme)[ Packagist](https://packagist.org/packages/upstatement/timber-starter-theme)[ RSS](/packages/upstatement-timber-starter-theme/feed)WikiDiscussions 2.x Synced 1mo ago

READMEChangelog (4)Dependencies (3)Versions (17)Used By (0)

The Timber Starter Theme
========================

[](#the-timber-starter-theme)

[![Build Status](https://camo.githubusercontent.com/a2319b223b954a9d95ca371c632499a2022323c58d8cc853877260c339d9ac8c/68747470733a2f2f7472617669732d63692e636f6d2f74696d6265722f737461727465722d7468656d652e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/github/timber/starter-theme)[![Packagist Version](https://camo.githubusercontent.com/b2c19bc5d67dca3ddb4490b91496681133f70105405f00ba65b8aa7e01da24f7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74696d6265722f737461727465722d7468656d653f696e636c7564655f70726572656c6561736573)](https://packagist.org/packages/timber/starter-theme)

The "\_s" for Timber: a dead-simple theme that you can build from. The primary purpose of this theme is to provide a file structure rather than a framework for markup or styles. Configure your SASS files, scripts, and task runners however you would like!

Installing the theme
--------------------

[](#installing-the-theme)

Follow the guide on [how to Install Timber using the Starter Theme](https://timber.github.io/docs/v2/installation/installation/#use-the-starter-theme).

Then,

1. Rename the theme folder to something that makes sense for your website. You could keep the name `timber-starter-theme` but the point of a starter theme is to make it your own!
2. Activate the theme in the WordPress Dashboard under **Appearance → Themes**.
3. Do your thing! And read [the docs](https://timber.github.io/docs/).

The `StarterSite` class
-----------------------

[](#the-startersite-class)

In **functions.php**, we call `new StarterSite();`. The `StarterSite` class sits in the **src** folder. You can update this class to add functionality to your theme. This approach is just one example for how you could do it.

The **src** folder would be the right place to put your classes that [extend Timber’s functionality](https://timber.github.io/docs/v2/guides/extending-timber/).

Small tip: You can make use of Composer’s [autoloading functionality](https://getcomposer.org/doc/04-schema.md#psr-4) to automatically load your PHP classes when they are requested instead of requiring one by one in **functions.php**.

What else is there?
-------------------

[](#what-else-is-there)

- `assets/` is where you can keep your front-end scripts, styles, or images. In other words, your Sass files, JS files, fonts, and SVGs would live here.
- `views/` contains all of your Twig templates. These pretty much correspond 1 to 1 with the PHP files that respond to the WordPress template hierarchy. At the end of each PHP template, you’ll notice a `Timber::render()` function whose first parameter is the Twig file where that data (or `$context`) will be used. Just an FYI.
- `tests/` ... basically don’t worry about (or remove) this unless you know what it is and want to.

Other Resources
---------------

[](#other-resources)

- [Twig for Timber Cheatsheet](https://notlaura.com/the-twig-for-timber-cheatsheet/)
- [Timber and Twig Reignited My Love for WordPress](https://css-tricks.com/timber-and-twig-reignited-my-love-for-wordpress/) on CSS-Tricks
- [A real live Timber theme](https://github.com/laras126/yuling-theme).

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance57

Moderate activity, may be stable

Popularity49

Moderate usage in the ecosystem

Community35

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 51.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 ~407 days

Recently: every ~500 days

Total

6

Last Release

499d ago

Major Versions

1.x-dev → 2.0.02023-11-29

### Community

Maintainers

![](https://www.gravatar.com/avatar/692aa0b61ab3442df442597fb9526c13d82252ec3836c574edab4a0b9b38dc38?d=identicon)[jarednova](/maintainers/jarednova)

---

Top Contributors

[![jarednova](https://avatars.githubusercontent.com/u/1298086?v=4)](https://github.com/jarednova "jarednova (123 commits)")[![gchtr](https://avatars.githubusercontent.com/u/2084481?v=4)](https://github.com/gchtr "gchtr (23 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (21 commits)")[![Levdbas](https://avatars.githubusercontent.com/u/17764157?v=4)](https://github.com/Levdbas "Levdbas (18 commits)")[![marciojc](https://avatars.githubusercontent.com/u/468890?v=4)](https://github.com/marciojc "marciojc (12 commits)")[![evankennedy](https://avatars.githubusercontent.com/u/2186350?v=4)](https://github.com/evankennedy "evankennedy (4 commits)")[![stefenphelps](https://avatars.githubusercontent.com/u/5756949?v=4)](https://github.com/stefenphelps "stefenphelps (4 commits)")[![naderabbara](https://avatars.githubusercontent.com/u/7019201?v=4)](https://github.com/naderabbara "naderabbara (3 commits)")[![tomlecki](https://avatars.githubusercontent.com/u/26721846?v=4)](https://github.com/tomlecki "tomlecki (2 commits)")[![daronspence](https://avatars.githubusercontent.com/u/4062087?v=4)](https://github.com/daronspence "daronspence (2 commits)")[![kaido24](https://avatars.githubusercontent.com/u/854774?v=4)](https://github.com/kaido24 "kaido24 (2 commits)")[![laras126](https://avatars.githubusercontent.com/u/445861?v=4)](https://github.com/laras126 "laras126 (2 commits)")[![lggorman](https://avatars.githubusercontent.com/u/5794405?v=4)](https://github.com/lggorman "lggorman (2 commits)")[![matbush](https://avatars.githubusercontent.com/u/2430413?v=4)](https://github.com/matbush "matbush (2 commits)")[![stephenniemans](https://avatars.githubusercontent.com/u/19666808?v=4)](https://github.com/stephenniemans "stephenniemans (2 commits)")[![titouanmathis](https://avatars.githubusercontent.com/u/250145?v=4)](https://github.com/titouanmathis "titouanmathis (1 commits)")[![mcegielka](https://avatars.githubusercontent.com/u/90417454?v=4)](https://github.com/mcegielka "mcegielka (1 commits)")[![mgiulio](https://avatars.githubusercontent.com/u/99207?v=4)](https://github.com/mgiulio "mgiulio (1 commits)")[![motia](https://avatars.githubusercontent.com/u/20706253?v=4)](https://github.com/motia "motia (1 commits)")[![bbarnwell](https://avatars.githubusercontent.com/u/7012067?v=4)](https://github.com/bbarnwell "bbarnwell (1 commits)")

---

Tags

phptimbertwigwordpress-theme

### Embed Badge

![Health badge](/badges/upstatement-timber-starter-theme/health.svg)

```
[![Health](https://phpackages.com/badges/upstatement-timber-starter-theme/health.svg)](https://phpackages.com/packages/upstatement-timber-starter-theme)
```

###  Alternatives

[mustache/mustache

A Mustache implementation in PHP.

3.3k44.6M291](/packages/mustache-mustache)[rareloop/lumberjack-core

A powerful MVC framework for the modern WordPress developer. Write better, more expressive and easier to maintain code

42155.0k19](/packages/rareloop-lumberjack-core)[nystudio107/craft-twigpack

Twigpack is a bridge between Twig and webpack, with manifest.json &amp; webpack-dev-server HMR support

97341.4k17](/packages/nystudio107-craft-twigpack)[mindkomm/timber-integration-woocommerce

WooCommerce integration for Timber.

11617.6k1](/packages/mindkomm-timber-integration-woocommerce)[localgovdrupal/localgov_base

The base theme for LocalGov Drupal websites.

13121.5k4](/packages/localgovdrupal-localgov-base)

PHPackages © 2026

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