Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A starter theme for WordPress, designed to give you a base to use when creating your own WordPress theme.
PHP JavaScript Ruby
branch: master
Failed to load latest commit information.
fonts/open-sans Move assets out of their own directory
images Move assets out of their own directory
includes Initial commit
js Remove compiled assets from repo
scss Move assets out of their own directory
.gitignore Add Composer files to .gitignore
Gruntfile.js Move JSHint options into Gruntfile
README.md Correct URL to Installing Compass wiki page
attachment-image.php Initial commit
comment.php Update DocBlock subpackages
comments-loop-nav.php Update DocBlock subpackages
comments-loop.php Update DocBlock subpackages
comments.php Update DocBlock subpackages
composer.json Add Composer file
config.rb Use Grunt to move CSS files to root instead of having Compass generat…
content-aside.php Update DocBlock subpackages
content-attachment.php Update DocBlock subpackages
content-audio.php Update DocBlock subpackages
content-chat.php Update DocBlock subpackages
content-gallery.php Update DocBlock subpackages
content-image.php Update DocBlock subpackages
content-link.php Update DocBlock subpackages
content-page.php Update DocBlock subpackages
content-quote.php Update DocBlock subpackages
content-status.php Update DocBlock subpackages
content-video.php Update DocBlock subpackages
content.php Update DocBlock subpackages
footer.php Initial commit
functions.php Update functions.php for Hybrid Core 1.6
header.php Update DocBlock subpackages
index.php Initial commit
license.txt Initial commit
loop-error.php Update DocBlock subpackages
loop-meta.php Update DocBlock subpackages
loop-nav.php Update DocBlock subpackages
loop.php Update Hybrid Core to 1.6
menu-primary.php Update DocBlock subpackages
menu-secondary.php Update DocBlock subpackages
menu-subsidiary.php Update DocBlock subpackages
package.json Use load-grunt-tasks instead of matchdep
screenshot.png Initial commit
sidebar-primary.php Update DocBlock subpackages
sidebar-secondary.php Update DocBlock subpackages
sidebar-subsidiary.php Update DocBlock subpackages

README.md

Theme Boilerplate

Theme Boilerplate is a starter theme for WordPress, designed to give you a base to use when creating your own WordPress theme.

Theme Boilerplate is built with Hybrid Core, Sass and Compass. It uses Grunt for build automation, and Composer for dependency management.

Getting Started

Clone the repo

First of all, clone the boilerplate using Git into a new theme directory (replace my-awesome-theme with the slug of your theme):

git clone https://github.com/bungeshea/theme-boilerplate my-awesome-theme
cd my-awesome-theme

Next, rename the boilerplate remote:

git remote rename origin boilerplate

If you're planning to deploy this theme using Git, add your own origin remote:

git remote add origin https://github.com/your-username/my-awesome-theme

Rebranding

You might like to rebrand the theme templates with the name of your theme. This can be accomplished by performing several search-and-replaces on the theme templates:

  1. Search for 'theme-boilerplate' to capture the text domain.
  2. Search for boilerplate_ to capture all the function names.
  3. Search for Theme_Boilerplate to capture DocBlock packages.
  4. Search for Theme Boilerplate to capture comments.
  5. Search for boilerplate- to capture prefixed handles.

Also open up scss/style.scss and package.json and manually replace the information contained in those files. scss/style.css is used by WordPress to determine the theme information, and package.json is used by node when installing modules such as Grunt plugins.

Building the theme

Theme Boilerplate requires Composer, Grunt, and Compass to be installed.

Once you have installed those three software by following the instructions on the linked pages, you can ready to build the theme. Initially, you will need to install Composer packages and Node modules:

composer install
npm install

The next step is to build the assets. This is done using Grunt. To compile Sass into CSS, minify the compiled CSS, and minify and concatenate JavaScript, all you need to do is run the default task like so:

grunt

Compressing images is not available through the default task, and must be ran manually:

grunt imagemin

Once you have run the default task for the first time, you can run the watch task which will poll for changed files and run the appropriate tasks on them. If you have the LiveReload browser extension installed, you can enable it when running the watch task, and everything will just work.

grunt watch

Staying up to date

When a new version of Theme Boilerplate is released, you can pull in the changes using Git:

git pull boilerplate master

Make sure all of your changes are committed first.

Something went wrong with that request. Please try again.