Grunt is a NodeJS task runner that allows you to automate all the things! I use it to speed up my development workflow and enhancing the performance of my projects.
2 Years: A Sour Memory
It's Thursday. I've just started a front-end project that needs to be done...tomorrow. I've started a new WordPress site for a client that we needed to churn out quickly, so I open up Coda, start to manually scaffold out a theme, manually create my php and html files, manually start to add CSS, then I flip over to my browser, hit the refresh button and watch the page reload.
Fast forward to the next day, and I'm cleaning up code, trying to make files smaller (and doing an awful job) and I finally wrap it up, and manually drag files into ftp in Coda, then manually sanity the site and call it a day.
And then I found Grunt.
As I'm writing this post, I've got Chrome open in the background and SublimeText 3 open taking half of the screen. I save my file and watch chrome magically update to my most recent markdown file's changes.
This is just one advantage of Grunt.
Grunt has become one of those things in life where you didn't realize just how badly you needed it until you start using it and thinking, "what have I been doing with my life?"
By automating all the things I used to have to manually do, I make more time to do more things, and ultimately make more time to focus on the important things while Grunt takes care of the trivially mundane.
Advantages to Using Grunt
- It has a huge library of plugins to automate almost anything you can think of, the community on a whole is using Grunt for all of their projects (jQuery, twitter, Modernizr) which leads to contributing, which leads to more plugins, which, as you guessed, leads to greater adoption.
- Easy to get up and running and lots of documentation.
- Robust enough that you can use it for any kind of tasks, but minimal enough that it's not bloated unless you need it to be.
I've added all of these code samples to a github gist, you can clone done the repo, and run the commands as you read rather than having to write out the examples yourself if it's more convenient.
Project gist: Grunt: Up & Running
Grunt has a few dependencies that you'll need to have installed:
- NodeJS >=0.8.8
- npm (comes with the Node package)
From anywhere within your terminal run:
This is going to install the module for the command line tool globally (-g) so you can run
grunt anywhere on your machine and it will know what you're referencing.
Next, in your project's root, you'll need to create a
npm init in your project) and a
Gruntfile.js. The package.json file is a NodeJS file that tells Node about all the attributes of your project and the different Node modules your project will depend on.
Here's my sample
After you've created your
package.json, you'll need to run
npm install, which is going to install grunt, jshint and uglify (any dependencies you specify in your
The final piece of the Grunt puzzle is to create your
In it we're going to have it run two tasks:
- uglify it if there aren't any errors
We'll create a default task and add the options to the
script.js, the path being relative to the Gruntfile's location.
At the very least for running
grunt to work, you have to:
registerTaskof default and add the tasks you want to run
loadNpmTasksof all the tasks that are in your configuration object.
The only thing we need to do for this to work is to add a
Now that we have everything setup, , and you can switch back to your terminal and run
grunt from anywhere in your project (I always run it from the project root just to be safe), and grunt will run jshint and uglify on your script with the package name!
Having to run
grunt every time you make a change can be a real hassle, so for convenience to almost every project I use, I add the
grunt-contrib-watch task, so let's go ahead and add it as a task:
When you do this as
--save-dev it will add it to your developer dependencies in your
package.json file, which will help you out in the long run, especially if you want other people to use your project. If you don't pass in the flag to save as a dependency, when someone else pulls down your project and tries to work with it, they'll have to manually install node modules and most likely give up on your project.
package.json after saving dev dependency for watch:
Now that we have the ability to watch files, we can add it to our
With an updated file, we can simply run
If you're using Grunt, let me know what you like/don't like about it, or some of the really useful plugins you've found! I'll be adding posts every month about the plugins that I find useful for my workflow.