Genesis Starter
A Genesis Framework starter theme with Gulp support. I took StudioPress' original Genesis Sampler theme and added my stuff.
Requirements
- WordPress
- Genesis Framework
- Composer
- Node (for NPM)
- Gulp
- Browserify
- Sass
- GraphicsMagick (for
gulp-unretina)
Setup
- Clone this repository and change the theme's name.
- There is no
style.cssin the root, that is built by Gulp. The header comment metadata can be edited atsrc/sass/_meta.scss. - Run
composer installto install PHP dependencies. - Run
npm installto setup the build tools and install JavaScript dependencies. - Run
gulp buildto generate public site assets from sources.
CSS Preprocessor Support
Genesis Starter uses Sass out of the box, but it should not be at all hard to configure a Gulp task to handle different preprocessors (such as LESS or Stylus).
JavaScript and Browserify
The Starter uses Browserify to better allow modularization of client-side code using modules.
By default, your code is concatenated into a file called app.js, while external dependencies (installed using NPM) are concatenated into infrastructure.js.
The Browserify build process also handles ECMAScript 2015 transparently, using Babel to convert it into the kind of JavaScript most browsers support today.
Build Tasks
The Genesis starter provides the following Gulp tasks.
| Task | Description |
|---|---|
watch |
Watches files for changes and rebuilds assets (default). |
build |
Runs browserify, fonts, sass and images. |
test |
Runs ava and phpunit. |
clean |
Deletes the built assets so you can start afresh. |
ava |
Runs AVA tests. |
browser-sync |
Reloads and syncs browsers on multiple devices. |
browserify |
Packages JavaScript bundles from their sources. |
eslint |
Lints your JavaScript code. |
fonts |
Converts web fonts to CSS for localStorage caching. |
images |
Copies and compresses image assets. |
phpunit |
Runs PHPUnit test cases. |
sass |
Compiles, minifies and concatenates CSS from Sass. |
Task parameters may be configured via the gulp/config.js file.
BrowserSync
The watch task uses BrowserSync to observe files, automate browser refreshes and allow synchronised testing between different devices on the same site.
In order to do this, BrowserSync creates a local proxy that channels connections to the development site defined in the browserSync.proxy entry of gulp/config.js.
The proxy configuration requires that your WordPress site be available from multiple domain or host names, a feature offered by a plugin such as WP Hydra. (I recommend that you use these plugins for development only, since activating them on a public site could severely affect your site's search rankings.)
Feel free to experiment (and report on) different BrowserSync configurations, but from those I've tried this is the one that work best for me.
License
Genesis Starter is released under the GPL 2.0 Free Software License.