grunt-wp-scratch

Create a WordPress child theme for Scratch with grunt-init.

Installation

If you haven't already done so, install grunt-init.

Once grunt-init is installed, place this template in your ~/.grunt-init/ directory. It's recommended that you use git to clone this template into that directory, as follows:

Linux/Mac Users

git clone git@github.com:mrdink/grunt-wp-scratch.git ~/.grunt-init/wp-scratch-child

Windows Users

git clone git@github.com:mrdink/grunt-wp-scratch.git %USERPROFILE%/.grunt-init/wp-scratch-child

Usage

At the command-line, cd into an empty directory, run this command and follow the prompts.

grunt-init wp-scratch-child

Note that this template will generate files in the current directory, so be sure to change to a new directory first if you don't want to overwrite existing files.

Development

Enable "Live Reload" under Advanced in the theme customizer to turn on livereload.js for development with grunt.

Production

After running grunt prod enable "Use minified assets" to use production files.

Install Grunt and Bower

Unfamiliar with npm? Don't have node installed? Download and install node.js before proceeding.

From the command line:

  1. Install grunt-cli and bower globally with npm install -g grunt-cli bower.
  2. Navigate to the theme directory, then run npm install. npm will look at package.json and automatically install the necessary dependencies. Also run bower install, which installs front-end packages defined in bower.json.

When completed, you'll be able to run the various Grunt commands provided from the command line.

Available Grunt commands

  • grunt dev — Compile Sass to CSS, concatenate and validate JS
  • grunt watch — Compile assets when file changes are made
  • grunt prod — Create minified assets that are used on non-development environments
  • grunt package — Runs all tasks, copies all files excluding dev files, and compresses into a zip file

Credit

Forked from grunt-wp-theme by 10up.

Icon created by iconsmind.com from the Noun Project