node package manager


Background processing for the CleverStack Framework

CleverStack Background Tasks Module

This CleverStack Module provides the ability to run multiple background processes that can run "Tasks", this free's the event loop up inside the http workers to respond to web requests while processing can take place in the background.

See for more detailed information on the Node seed or visit the Getting Started Guide

Simply add the following config to your /config/local.json (or into your global.json for all environments, or in whatever environment you are using). See

  1. grunt prompt:cleverBackgroundTasksConfig can be used to generate your config for any environment you want
  2. grunt prompt:addBackgroundTask can be used to add/edit tasks inside your config
    "clever-background-tasks": {
        "enabled" : true,
        "interval": 2500,
            { "name": "ExampleTask", "parallel": true }
        "driver": "redis",
        "redis": {
            "host": "localhost",
            "port": "11211"
  1. Run clever install clever-background-tasks and follow the prompts
  2. Run clever serve to start your application.
  1. Clone this repo (or untar it there) into your modules folder (ie modules/clever-background-tasks)
  2. Add 'clever-background-tasks' to the bundledDependencies array of your app's package.json.
  3. Run grunt prompt:cleverBackgroundTasksConfig and fill in your configuration options.
  4. Run grunt prompt:addBackgroundTask to add any tasks to your running configuration.
  5. Run grunt server to start your application.