build-workflow

IMPORTANT

If I have to start again, I will probably not choose any build tool but directly embrace the npm as build tool* trend. Grunt has indeed helped me a lot, there are lot of plugins available, it is easy to configure, but it can get really messy for a fairly complex build workflow. And that's the same with gulp or all the other build tools out there.

I still have some fairly complex web projects that use grunt and this module is still great to help me organize them.

For more info on how to use npm as a build tool check:

• task automation with npm
• npm as a build tool

Build Workflow

A module that helps to break a gigantic Gruntfile into smaller modules that are easy to manage and reason about. It also provide some tasks, helpers and utilities for common tasks

Overview

This module aims to simplify the creation of workflows based on grunt, I know gulp is better :) or webpack or (insert better tool here) Since some of the projects I'm working right now are still using grunt, I wanted to have a better way to manage the build workflows.

This module is inspired by this blog post supercharging your gruntfile

The main differences are:

• config files always export a function that return an object. All the config exported functions receive the grunt object, the pkg, package.json parsed object
• Custom grunt tasks can be placed inside the grunt-deps/tasks folder they will be loaded automatically.
• It does not use yaml, so the aliases for tasks are defined in javascript. This is to keep it simple and avoid leaving the javascript realm.

Usage

Create the following folder structure

- grunt-deps
  - configs           # this will be directory where configs should live
    - task-name.js    # should correspond to the name of the task and should return an object.
                      # The object will be set in the cfg as cfg[task-name].
  - tasks
    - custom-task.js  # place here custom tasks. These can be either multitasks or single tasks
                      # that for whatever reason are only needed in the current project
  - workflows
    - aliases.js      # use this file to define the sequence of your tasks.

- Gruntfile.js        # the grunt
- package.json        # your package.json

Gruntfile

This is all the code required for your grunt file

module.exports = function ( grunt ) {
  'use strict';
  require( 'build-workflow' )( grunt );
};

Since each config block will be defined inside the config folder the Gruntfile is effectively broken into several pieces which are easier to manage that a gigantic configuration file.

Changelog

Read it here

License

MIT

Changelog

v7.0.0

• Refactoring

  • Big refactoring this module not longer bundle any tasks - 1b97c71, royriojas, 11/08/2015 18:16:59

    BREAKING CHANGE: this means that this module will only take care of break your gigantic grunt-file and auto load modules.