/bourbon-genesis

Genesis Starter theme utilizing the Bourbon.io SASS library. This is a fork of Matt Banks Starter theme. I switched out Compass for Bourbon and also added PostCSS as a backend task for the final style sheet. Enjoy.

Primary LanguagePHP

WordPress Genesis Starter Child Theme with Bourbon

Version: 1.4

Contributors:

John Lauber ( @johnlauber / littlelauberdesigns.com)

Summary

WordPress Starter Theme for use as Child Theme of the Genesis Framework for building custom themes, using Bourbon/SCSS and Grunt. Tested with WordPress 3.9.2 (and now 4.0) and Genesis 2.1.2. This is a fork of Matt Banks Starter theme that's using Compass/SCSS.

Usage

The theme is setup to use Gulp to compile Bourbon/SCSS, 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 assets/styles/source/style.scss intro block to your theme information. Open the theme directory in terminal and run npm install to pull in all Gulp dependencies. Run gulp to execute tasks. Change theme 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 assets/js/source/main.js to assets/js/main.min.js
  • Publish and enjoy the fruits of your labor.

In the gulp.js file, be sure to change the BrowserSync line "local.testing.dev" to your local web address you want to sync.

Bourbon gets loaded as a dependency in package.json and gulp.js. There may be a better way to do this, but I haven’t found it yet.

Bower

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

Features

  1. Bourbon & SCSS with easy-to-use of mixins ready to go
  2. Easy to customize
  3. Grunt and LiveReload to make it more gooder
  4. Child theme tweaks
  5. Utilizes PostCSS for browser backwards compatibility
  6. Utilizes BrowserSync for testing across devices

Suggested Plugins

Requires: bourbon.io

Changelog

Version 2.1

Now with Gulp. I noticed Grunt was starting to fall out of favor, through various blogs and decided I should switchover. So ignore anything that references Grunt and learn to use Gulp.

Version 2.0

Updated the theme to utilize the latest changes in the Genesis Sample theme. Cut out any "old stuff". Calling it version 2.0 since I reworked the SCSS files.

Version 1.5.1

Removing the required plugin functionality. SEO plugin is now optional as I'm moving towards SEO Framework and not using Yoast SEO.

Version 1.5

Removed some older PostCSS plugins. Added in new dependencies for minimizing and packing the stylesheet.

Version 1.4

Moved the Google Font enqueue to the functions file and removed the static resource filter on the CSS files. This was not allowing the enqueueing of the Google fonts. Just replace the string from Google Fonts if using different fonts and change SCSS appropriately.

Version 1.3

  • With the release Genesis 2.2, I added the accessibility features to the functions and created a new scss partial to hold the latest Genesis Sample additions.

Version 1.2.2

  • Minor change to tasks order in GruntFile. BrowserSync starts last instead of first in case there's an error in the other tasks. PostCSS runs immediately after SASS, which seems more logical too.

Version 1.2.1

  • Moved all media queries (out of the _genesis.scss partial) to the correct _media.scss partial. It should have been there in the first place.

Version 1.2

  • Updated plugin activation code with the latest version of TGM Plugin Activation.

Version 1.1

  • Updated package.json and gruntfile to use new autoprefixer (PostCSS) with flexbox fixer.
  • Removed some of the includes from bourbon as they're deprecated.

Verson 1.0

  • Thanks to Matt for the starter
  • Changed the grunt file and main style sheet to use Bourbon mixins
  • initial version

Credits

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