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.
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
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
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
yarnfrom the theme directory to install dependencies
bud.config.jswith your local dev URL
yarn build— Compile assets
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