WordPress Genesis Starter Child Theme
Version: 3.0.0
Author:
Matt Banks ( @mattbanks / collectivthkg.com / mattbanks.me )
Summary
WordPress Starter Theme for use as Child Theme of the Genesis Framework for building custom themes. Uses SCSS, AutoPrefixr and Grunt for all processing tasks. Syncs changes across local development devices with BrowserSync. Tested up to WordPress 4.0 RC1 and Genesis 2.1.2.
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.scsstostyle.css - Compile
assets/styles/editor-style.scsstoeditor-style.css - Concatenate and minify plugins in
assets/js/vendorandassets/js/source/plugins.jstoassets/js/plugins.min.js - Minify and lint
assets/js/source/main.jstoassets/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.
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
- SCSS with AutoPrefixr and easy-to-use of mixins ready to go
- Easy to customize
- Grunt and BrowserSync to make it more gooder
- Child theme tweaks
- More to come!
Suggested Plugins
- WordPress SEO by Yoast
- Google Analytics for WordPress by Yoast
- W3 Total Cache
- Gravity Forms
- Pods Framework
Contributing:
Anyone and everyone is welcome to contribute! Check out the Contributing Guidelines.
Credits
Without these projects, this WordPress Genesis Starter Child Theme wouldn't be where it is today.