Skip to content
WordPress Starter Theme for use as a starting template for building custom themes. Uses SCSS, Normalize, AutoPrefixr, Grunt for compilation/linting/deployments, and BrowserSync for cross-device auto refreshing.
PHP CSS JavaScript
Failed to load latest commit information.
assets add empty spritesheet.scss partial, fixes #19 Jul 31, 2015
languages update pot file based on _s Apr 7, 2014
lib remove pods, add CFS and CFS Options Screens Jul 30, 2015
templates update to latest _s code base, remove old files, reorganize SCSS Mar 27, 2014
.bowerrc add bower config to set directory Jul 24, 2013
.gitignore update to latest _s code base, remove old files, reorganize SCSS Mar 27, 2014
.jshintrc remove es5 as it's now on by default Jun 18, 2013
404.php updates based on latest _s Sep 3, 2014
CHANGELOG.md changelog for v4.2.2 Jul 30, 2015
CONTRIBUTING.md add contributing doc Mar 19, 2014
Gruntfile.js make browserSync open Chrome Jul 30, 2015
README.md update version, add jjmu15 as contributor Jul 30, 2015
archive.php updates based on latest _s Sep 3, 2014
comments.php updates based on latest _s Sep 3, 2014
content-none.php update to latest _s code base, remove old files, reorganize SCSS Mar 27, 2014
content-page.php update based on latest _s May 27, 2014
content-search.php updates based on latest _s Sep 3, 2014
content-single.php updates based on latest _s Sep 3, 2014
content.php updates based on latest _s Sep 3, 2014
footer.php updates based on latest _s Sep 3, 2014
front-page.php update front page template Mar 27, 2014
functions.php fix paths for include files, use require instead of require once Mar 27, 2014
header.php updates based on latest _s Sep 3, 2014
index.php update to latest _s code base, remove old files, reorganize SCSS Mar 27, 2014
package.json update packages Jul 30, 2015
page.php update to latest _s code base, remove old files, reorganize SCSS Mar 27, 2014
screenshot.png updates based on latest _s Sep 3, 2014
search.php updates based on latest _s Sep 3, 2014
sidebar.php updates based on latest _s Sep 3, 2014
single.php updates based on latest _s Sep 3, 2014

README.md

WordPress Starter Theme

Version: 4.2.2

Author:

Matt Banks ( @mattbanks / collectivthkg.com / mattbanks.me )

Summary

WordPress Starter Theme for use as a starting template for building custom themes. Uses SCSS and AutoPrefixr, HTML5 Boilerplate with Modernizr and Normalize.css, and Grunt for all processing tasks. Syncs changes across local development devices with BrowserSync. Tested up to WordPress 4.0 RC1.

Usage

The theme is setup to use Grunt to compile SCSS (with source maps), run it through AutoPrefixr, lint, concatenate and minify JavaScript (with source maps), optimize images, and syncs changes across local development devices with BrowserSync, with flexibility to add any additional tasks via the Gruntfile. Alternatively, you can use CodeKit or whatever else you prefer to compile the SCSS and manage the JavaScript.

Rename folder to your theme name, change the style.scss intro block to your theme information. Open the theme directory in terminal and run npm install to pull in all Grunt dependencies. Run grunt to execute tasks. Code as you will.

If you are using MAMP or Vagrant, change the proxy option in the grunt browserSync task to match your vhost URL.

  • Compile assets/styles/style.scss to style.css
  • Compile assets/styles/editor-style.scss to editor-style.css
  • Concatenate and minify plugins in assets/js/vendor and assets/js/source/plugins.js to assets/js/plugins.min.js
  • Minify and lint assets/js/source/main.js to assets/js/main.min.js
  • ??
  • Profit
  • Create sprites by adding PNGs to assets/images/sprites and use by referencing created classes in assets/styles/partials/_spritesheet.scss

To concatenate and minify your jQuery plugins, add them to the assets/js/vendor directory and add the js filename and path to the Gruntfile uglify task. Previous versions of the starter theme automatically pulled all plugins in the vendor directory, but this has changed to allow more granular control and for managing plugins and assets with bower.

Bower

Supports bower to install and manage JavaScript dependencies in the assets/js/vendor folder.

Deployment

The theme includes deployments via grunt-rsync. The Gruntfile includes setups for staging and production - edit your paths and host, then run grunt deploy:staging or grunt deploy:production to deploy your files via rsync.

Features

  1. Normalized stylesheet for cross-browser compatibility using Normalize.css version 3 (IE8+)
  2. Easy to customize
  3. Flexible grid based on work from Chris Coyier
  4. Media Queries can be nested in each selector using SASS
  5. SCSS with plenty of mixins ready to go
  6. Grunt for processing all SASS, JavaScript and images, and cross-device refreshing with BrowserSync
  7. Much much more

Suggested Plugins

dependencies

Contributing:

Anyone and everyone is welcome to contribute! Check out the Contributing Guidelines.

Contributors:

Credits

Without these projects, this WordPress Starter Theme wouldn't be where it is today.

Something went wrong with that request. Please try again.