A Genesis Framework starter theme with Gulp support. I took StudioPress' original Genesis Sampler theme and added my stuff.
- Genesis Framework
- Node (for NPM)
- GraphicsMagick (for
- 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 at
composer installto install PHP dependencies.
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).
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
The Genesis starter provides the following Gulp tasks.
||Watches files for changes and rebuilds assets (default).|
||Deletes the built assets so you can start afresh.|
||Runs AVA tests.|
||Reloads and syncs browsers on multiple devices.|
||Converts web fonts to CSS for
||Copies and compresses image assets.|
||Runs PHPUnit test cases.|
||Compiles, minifies and concatenates CSS from Sass.|
Task parameters may be configured via the gulp/config.js file.
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.
Genesis Starter is released under the GPL 2.0 Free Software License.