node package manager
It’s your turn. Help us improve JavaScript. Take the 2017 JavaScript Ecosystem Survey »



An asset manager for the Particles platform, based on Grunt.


Build Status Dependency Status

What it does

The current pipeline will:

  • Clean the old temporary assets directory
  • Collect all assets directories using Scatter services register_assets_dir, register_views_dir
  • Gather all assets into a temporary directory
  • Compiles stylesheets registered with the Scatter service use_scripts
  • Inject scripts, stylesheets and views from respectively the services use_scripts, use_stylesheets, contribute_views
  • [Optional] Watch all the registered assets dirs for changes and re-run the pipeline if any change is detected
  • [Optional] Run the application entry point (config param main) and restart the application if any change in the application source (registered particles) is detected.

Limitations (TODO):

  • Does not minify/bundle for production yet
  • Supports only Jade for injections

Available Grunt Tasks

  • particles-update: build assets without cleaning
  • particles-build: clean and build assets
  • particles-build-and-watch: build then start to watch assets for changes
  • particles-develop: build assets, starts the app. Watch assets and sources.

Before any of the above task can be run, a grunt-particles task has to execute to kickstart and configure the Scatter container.


  • assets.viewsDir
  • assets.assetsDir
  • [assets.publicUrlRoot]

Example config


  "generatedDir": "${appRoot}/generated",
  "assets": {
    "viewsDir": "${generatedDir}/views/",
    "assetsDir": "${generatedDir}/assets/",
    "publicUrlRoot": "public"
  "particles": {
    "app": {
      "particles": ["${appRoot}/lib"]



Bitdeli Badge