Dueper Thor Theme
MIT License
Sage is a WordPress starter theme with a modern development workflow.
See a working example at roots-example-project.com.
Make sure all dependencies have been installed before moving on:
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 roots/sage your-theme-name
To install the latest development version of Sage, add dev-master
to the end of the command:
$ composer create-project roots/sage your-theme-name dev-master
During theme installation you will have options to update style.css
theme headers, select a CSS framework, and configure Browsersync.
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 # Theme setup
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 templates
layouts/ # Base templates
partials/ # Partial templates
vendor/ # Composer packages (never edit)
Edit app/setup.php
to enable or disable theme features, setup navigation menus, post thumbnail sizes, and sidebars.
yarn
from the theme directory to install dependenciesresources/assets/config.json
settings:
devUrl
should reflect your local development hostnamepublicPath
should reflect your WordPress folder structure (/wp-content/themes/sage
for non-Bedrock installs)yarn start
Compile assets when file changes are made, start Browsersync sessionyarn build
Compile and optimize the files in your assets directoryyarn build:production
Compile assets for productionContributions are welcome from everyone. We have contributing guidelines to help you get started.
Help support our open-source development efforts by becoming a patron.
Keep track of development and community news.