Skip to content
Sage
v10.8.2
  • Sage page

Installation

# What is Sage?

Sage is a WordPress starter theme.

# Why use Sage?

  • Harness the power of Laravel and its available packages thanks to Acorn.
  • Clean, efficient theme templating utilizing Laravel Blade.
  • Lightning fast frontend development workflow powered by Bud.
  • Out of the box support for Tailwind CSS.

# Getting Started

Windows users

WSL is required in order to use Sage. Build commands must be ran from a WSL environment.

Sage relies on Node.js based tools to manage dependencies and build assets. We recommend using Volta to install and manage Node.js. We also recommend using Yarn. After installing Volta:

# Install the latest Node.js LTS release
$ volta install node

# Globally install Yarn
$ npm install --global yarn

# Installing Acorn

Sage requires Acorn but doesn't ship with it included. This is to give you the flexibility to include it in a way that works best for your environment. There's a few different ways to install Acorn.

See the Acorn installation docs for additional details.

# Installing Sage with Composer

Install Sage using Composer from your WordPress themes directory (replace your-theme-name below with the name of your theme):

# From your WordPress themes directory, run:
$ 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

# Build assets

You must build theme assets in order to access your site. Failing to build the assets will result in the error:

The manifest [/path/to/sage/public/manifest.json] cannot be found.

# Running the first build

  • Run yarn from the theme directory to install dependencies
  • Update bud.config.js with your local dev URL
  • yarn build — Compile assets

Contributors

Last updated

Support Roots

Help us continue to build and maintain our open source projects. We’re a small team of independent developers and every little bit helps.

Sponsor Roots on GitHub