Contents

# Capistrano::Grunt

This gem will let you run [Grunt](http://gruntjs.com/) tasks with Capistrano 3.x.

## Installation

Add this line to your application's Gemfile:

```bash
gem 'capistrano', '~> 3.0'
gem 'capistrano-grunt', github: 'roots/capistrano-grunt'
```

And then execute:

```
$ bundle install
```

2. Add to `Capfile` or `config/deploy.rb`:

```ruby
require 'capistrano/grunt'
```

## Usage

Set what Grunt tasks you want run in your `deploy.rb` file:

```ruby
set :grunt_tasks, 'deploy:production'
```

If you don't set `:grunt_tasks`, Grunt will run without any task specified. (equivalent to just running `grunt` from the command line).

To run multiple tasks (can be string or array of strings):

```ruby
set :grunt_tasks, 'deploy:production cdn'
set :grunt_tasks, %w{deploy:production cdn}
```

The above would be equivalent of running the following from the command line:

```bash
grunt deploy:production cdn
```

Then add the task to your `deploy.rb`:

```ruby
before :updated, 'grunt'
```

## Configuration

To specify a `Gruntfile`, use the `:grunt_file` option:

```ruby
set :grunt_file, -> { release_path.join('config/Gruntfile.js') }
```

All configurable options are shown here with their defaults:

```ruby
set :grunt_file, nil
set :grunt_tasks, nil
set :grunt_flags, '--no-color'
set :grunt_roles, :all
set :grunt_target_path, nil
```

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
capistrano-grunt-0.0.3	README.md