NuGet Package Manager


    0.3.1 • Public • Published

    NPM version Build Status Dependency Status

    The Particles platform

    Particles is a Node.js platform built on top of the Scatter IoC container.

    The Particles platform is composed by a core, providing basic services (log, configuration) plus a set of ready-to-use, drop-in solutions to create modular and extensible Node.js applications.

    Particles components can contain server side code as well as client side scripts and assets, like css, images and templates!

    Particles is not another framework, it does not want to impose the use of any particular library or technology, but on the other side it encourages the use of patterns like Dependency Injection and Service locator to build applications.


    1 - Experimental

    Please try it out and provide feedback.

    Basic usage

    • To bootstrap your own Particles-based app, create an empty git repository:
    $ mkdir MYAPP && cd MYAPP
    $ git init
    • Checkout the particles-seed repository
    $ git remote add particles-seed -m master
    $ git pull -s recursive -X theirs particles-seed master
    • Install the new project
    npm install
    • Run the app
    node app

    What happened? At startup the Scatter service app_start will be executed. A sample of such a service can be found in the file app/entryPoint.js.

    Not too exciting for now, but let's start to build our app.

    Adding particles

    Let's add a new particle to our app. Particles are drop-in components, it means you don't need to initialize or require them in your code in order to activate them. It's the magic of having an IoC container!

    Let's add an express server to our application

    npm install particles-express

    That's it, yes really, not kidding. No custom executable to run, no code to write, just installing an npm package. Now you just fire up your app again and see what happens

    node app

    Try to access http://localhost:3000/ to check what your new server have to say.

    Using the services of a particle

    Of course our express server is not that useful as it is right? Let's register a new route in our app internal particle. Create a new file app/controllers/HelloController.js and drop in this code:

    var self = module.exports = {
        helloWorld: function(req, res) {
            res.send('200', 'My first controller works!');
        setup: function(express) {
"Initialize my first controller...");
          express.get("/hello", self.helloWorld);
    module.exports.__module = {
        properties: {
            log: "controllers/log"
        provides: 'controllers/setup'

    Restart your server and look at http://localhost:3000/hello

    A couple of things to notice here:

    • The log object (a core Particles service) is injected into our module by the IoC container. Almost any module can be injected and shared across all the particles of your app!
    • To register a new route, a new service was exposed, called setup. This service is invoked by particles-express to register new routes. Yes, that's right, particles can communicate with each other not only by using DI, but also by invoking services across all the particles of your app.

    Working with assets

    ...coming soon

    Feedback & Social

    Follow @particlesjs on Twitter for updates.

    Also there is a Google group you can use to ask questions and discuss about Particles. Visit the Hadron Particles Google group.





    npm i particles

    DownloadsWeekly Downloads






    Last publish


    • mariocasciaro