Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

WordPress Starter Theme for use as a starting template for building custom themes. Uses Compass, SCSS, Normalize, and Grunt for compilation/linting/deployments.

Octocat-spinner-32 assets add header and footer partials March 27, 2014
Octocat-spinner-32 languages update pot file based on _s April 07, 2014
Octocat-spinner-32 lib update doc blocks based on _s April 07, 2014
Octocat-spinner-32 templates update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 .bowerrc add bower config to set directory July 24, 2013
Octocat-spinner-32 .gitignore update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 .jshintrc remove es5 as it's now on by default June 18, 2013
Octocat-spinner-32 404.php add additional content for 404 template by default April 07, 2014
Octocat-spinner-32 CHANGELOG.md update for v4.0.0 March 27, 2014
Octocat-spinner-32 CONTRIBUTING.md add contributing doc March 19, 2014
Octocat-spinner-32 Gruntfile.js update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 README.md update for v4.0.0 March 27, 2014
Octocat-spinner-32 archive.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 comments.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 content-none.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 content-page.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 content-single.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 content.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 footer.php add doc block headers April 07, 2014
Octocat-spinner-32 front-page.php update front page template March 27, 2014
Octocat-spinner-32 functions.php fix paths for include files, use require instead of require once March 27, 2014
Octocat-spinner-32 header.php add doc block headers April 07, 2014
Octocat-spinner-32 index.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 package.json bump package versions April 07, 2014
Octocat-spinner-32 page.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 screenshot.png initial version December 08, 2011
Octocat-spinner-32 search.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 sidebar.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
Octocat-spinner-32 single.php update to latest _s code base, remove old files, reorganize SCSS March 27, 2014
README.md

WordPress Starter Theme

Version: 4.0.0

Author:

Matt Banks ( @mattbanks / kernelcreativemedia.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. Tested with WordPress 3.8.1.

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 LiveReload the browser (with extension), 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 have the LiveReload browser extension, it will reload after any SCSS or JS changes.

  • Compile assets/styles/source/style.scss to style.css
  • Compile assets/styles/source/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

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.

Image Optimization

To optimize images, run grunt imagemin. This was previously included in the default watch task, but there are currently a few issues with processing images multiple times and removing their contents.

Deployment

The theme includes deployments via grunt-rsync. The Gruntfile includes setups for staging and production - edit your paths and host, then run grunt rsync:staging or grunt rsync: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
  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.