JSPM

generator-roots-child

0.1.4
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1
  • Score
    100M100P100Q15727F

Scaffold out a Roots child theme

Package Exports

  • generator-roots-child

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (generator-roots-child) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Roots child theme generator

Version: 0.1.4

A Yeoman generator for scaffolding a custom Roots child theme.

Contributors

Duane Cilliers ( @duanecilliers / signpost.co.za / duane.co.za )

Summary

A Roots child theme generator for WordPress. Choose between Sass Bootstrap, LESS Bootstrap or CSS bootstrap, optionally include Modernizr with leaner builds and Grunt for all tasks.

Features

  • All the benefits of Roots
  • Choose between Sass Bootstrap, LESS Bootsrap or no CSS pre-processor (enqueues minified Bootstrap).
  • LiveReload the browser (with extension)
  • CSS Autoprefixing
  • Automatically compile Compass/Sass/Less
  • Automatically lint, concatenate and minify your JavaScript (with source maps)
  • Automatically version your styles and scripts with an md5 hash
  • Awesome Image Optimization (via OptiPNG, pngquant, jpegtran and gifsicle)
  • Optional - Leaner Modernizr builds
  • Deploy your theme via Rsync

Usage

  • Make sure you have yo installed: npm install -g yo
  • Install the generator: npm install -g generator-roots-child
  • Run yo roots-child inside an empty theme directory.
  • Run grunt for building and grunt dev for watching and compiling
  • Make sure you have Roots (the parent theme) installed

Bower

Supports bower to install and manage dependencies in the bower_components folder.

FAQs

  • Why are no styles reflecting?
    • If the 'WP_DEV_MODE' constant is set to true, be sure to run $ grunt dev to watch and compile changes. If 'WP_DEV_MODE' is not set or is false, minified assets are enqueued, so be sure to run $ grunt which compiles and minfies CSS and JavaScript. While developing, I suggest adding define( 'WP_DEV_MODE', true ) to wp-config.php.

TODOs

  • Consider deployment config prompts

License

MIT License