PHPackages                             ravorona/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 &amp; Helpers](/categories/utility)
4. /
5. ravorona/sage

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

ravorona/sage
=============

Wordpress theme based on Sage starter theme using Vite

4.3.1(2y ago)463212[2 issues](https://github.com/ravorona/sage/issues)MITSCSSPHP ^8.1

Since Aug 13Pushed 2y ago3 watchersCompare

[ Source](https://github.com/ravorona/sage)[ Packagist](https://packagist.org/packages/ravorona/sage)[ RSS](/packages/ravorona-sage/feed)WikiDiscussions main Synced 5d ago

READMEChangelog (10)Dependencies (2)Versions (30)Used By (0)

[![Development](https://github.com/ravorona/sage/actions/workflows/develop.yml/badge.svg)](https://github.com/ravorona/sage/actions/workflows/develop.yml/badge.svg) [![Release](https://github.com/ravorona/sage/actions/workflows/publish.yml/badge.svg)](https://github.com/ravorona/sage/actions/workflows/publish.yml/badge.svg)

🧩 Wordpress Starter Theme
=========================

[](#-wordpress-starter-theme)

- Based on [Sage](https://roots.io/sage/) version [10](https://github.com/roots/sage/)
- Using [Vite](https://vitejs.dev)

Requirements
------------

[](#requirements)

- [Acorn](https://roots.io/acorn/docs/installation/) v3
- [PHP](https://secure.php.net/manual/en/install.php) &gt;= 8.0 ( with [`php-mbstring`](https://secure.php.net/manual/en/book.mbstring.php) enabled)
- [Composer](https://getcomposer.org/download/)
- [Vite](https://vitejs.dev) &gt;= 3.1.0
- [Node.js](http://nodejs.org/) &gt;= 16.0.0
- [Yarn](https://yarnpkg.com/en/docs/install)

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

[](#theme-installation)

- **Make sure that you have [Acorn installed](https://roots.io/acorn/docs/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 ravorona/sage your-theme-name
```

To install the latest development version of Sage, add `dev-develop` to the end of the command:

```
$ composer create-project ravorona/sage your-theme-name dev-develop
```

Theme structure
---------------

[](#theme-structure)

```
themes/your-theme-name/   # → Root of your Sage based theme
├── app/                  # → Theme PHP
│   ├── Providers/        # → Service providers
│   ├── View/             # → View models
│   ├── filters.php       # → Theme filters
│   ├── helpers.php       # → Global helpers
│   ├── medias.php        # → Medias helper
│   └── setup.php         # → Theme setup
├── composer.json         # → Autoloading for `app/` files
├── 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
│   ├── svg/              # → Theme svgs
│   └── views/            # → Theme templates
│       ├── components/   # → Component templates
│       ├── forms/        # → Form templates
│       ├── layouts/      # → Base templates
│       ├── partials/     # → Partial templates
        └── sections/     # → Section templates
├── screenshot.png        # → Theme screenshot for WP admin
├── style.css             # → Theme meta information
├── vendor/               # → Composer packages (never edit)
└── vite.config.ts        # → Vite configuration
```

Theme development
-----------------

[](#theme-development)

- Run `yarn` from the theme directory to install dependencies
- Update `vite.config.ts` for bundler fine tuning

### Build commands

[](#build-commands)

- `yarn dev` — Start dev server and hot module replacement
- `yarn build` — Compile assets
- `yarn lint` — Lint stylesheets &amp; javascripts
- `yarn lint:css` — Lint stylesheets
- `yarn lint:js` — Lint javascripts

### Hot Module Replacement

[](#hot-module-replacement)

#### Project Side

[](#project-side)

Add the following variables in your project `.env`

```
# Endpoint where the bundler serve your assets
HMR_ENTRYPOINT=http://localhost:5173
```

#### Theme side

[](#theme-side)

For advanced dev server configuration, copy `.env.example` according to [Vite naming convention and loading order](https://vitejs.dev/guide/env-and-mode.html#env-files) and update variables

#### FYI

[](#fyi)

Running HMR Mode remove the `public/manifest.json` file, so do not forget to re-run the assets compilation with `yarn build` if needed.

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

[](#documentation)

- [Sage documentation](https://roots.io/sage/docs/)
- [Controller documentation](https://github.com/soberwp/controller#usage)
- [Vite](https://vitejs.dev/guide/)

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~51 days

Recently: every ~87 days

Total

27

Last Release

768d ago

Major Versions

0.7.0 → 1.0.02021-05-31

1.0.1 → 2.0.02021-11-08

2.2.0 → 3.0.02022-03-25

3.2.1 → 4.0.22023-01-26

PHP version history (4 changes)0.1.0PHP &gt;=7.1

3.0.0PHP ^7.4|^8.0

4.1.0PHP ^8.0

4.2.1PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/730151?v=4)[яαvoroηα](/maintainers/ravorona)[@ravorona](https://github.com/ravorona)

---

Top Contributors

[![ravorona](https://avatars.githubusercontent.com/u/730151?v=4)](https://github.com/ravorona "ravorona (8 commits)")

---

Tags

sagesassthemetypescriptwordpresswordpress

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/ravorona-sage/health.svg)

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

###  Alternatives

[tgmpa/tgm-plugin-activation

TGM Plugin Activation is a PHP library that allows you to easily require or recommend plugins for your WordPress themes (and plugins).

1.8k222.5k13](/packages/tgmpa-tgm-plugin-activation)[aristath/kirki

Extending the WordPress customizer

1.3k73.0k4](/packages/aristath-kirki)[afragen/git-updater

A plugin to automatically update GitHub, Bitbucket, GitLab, or Gitea hosted plugins, themes, and language packs.

3.3k1.6k](/packages/afragen-git-updater)[justintadlock/hybrid-carbon

God-like post featured image script.

202.5k](/packages/justintadlock-hybrid-carbon)[typisttech/wp-admin-notices

A simplified OOP implementation of the WordPress admin notices

141.2k](/packages/typisttech-wp-admin-notices)

PHPackages © 2026

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