Wheelie isn't a task runner, a build system or a Gulp wrapper. It's just a common interface to your Gulp tasks so that you can share, re-use and easily update them, improving your automated workflow. It ships out of the box with:

A Task model to create custom tasks like you usually do with Gulp. The programmatic interface exposes a configuration callback so that other developers may re-use your task, overriding your defaults.
Tasks can be grouped together to create a recipe. Your frontend toolchain becomes a list of Gulp tasks and it can be versioned in a different repository. If you publish your recipe into npm, you can update your projects' toolchain with just a change in the project's package.json.
Nothing less that Gulp already offers you. Wheelie takes care about the Gulp configuration and it returns a gulp instance, configured as described in a recipe.
Wheelie is fast and without overhead; the Gulp configuration happens only once for each run.

Getting started

Install Wheelie with the official recipes registry::

$ npm install --save-dev wheelie wheelie-recipe

Create a gulpfile.js in your project root folder with the following content:

.. code-block:: javascript

// importing your gulp reference
var gulp = require('gulp');

// importing Wheelie constructor and a recipe
var Wheelie = require('wheelie');
var recipe = require('wheelie-recipe');

// adding a Wheelie recipe
var wheelie = new Wheelie();
wheelie.add(recipe);
wheelie.build();

// <-- at this point, Gulp is configured with a set of tasks available in the wheelie-recipe package

With the above Gulpfile, you can launch the watch task simply with:

.. code-block:: bash

$ gulp

Official recipes

wheelie-recipe_ is a recipe currently maintained by Wheelie core developers. We're not suggesting our way to write frontend applications, but just to inspire and enforce a community-driven way to write Wheelie recipes.

.. _wheelie-recipe: https://github.com/wheelie/wheelie-recipe

Testing

We use Jest_ as a test framework. Install all development dependencies and launch the test suite:

.. code-block:: bash

$ npm install
$ npm test

.. _Jest: https://facebook.github.io/jest/

Documentation

Full documentation for the project is available at http://wheelie.readthedocs.io/

License

Wheelie is released under the terms of the BSD LICENSE. Full details in LICENSE file.

Keywords

FAQs

What is wheelie?

Is wheelie popular?

Is wheelie well maintained?

Package last updated on 07 Aug 2016

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install