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.
- To bootstrap your own Particles-based app, create an empty git repository:
$ mkdir MYAPP && cd MYAPP$ git init
- Checkout the
$ git remote add particles-seed -m master$ git pull -s recursive -X theirs particles-seed master
- Install the new project
- Run the 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
Not too exciting for now, but let's start to build our app.
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
Try to access http://localhost:3000/ to check what your new server have to say.
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 = moduleexports =ressend'200' 'My first controller works!';self.log.info"Initialize my first controller...";expressget"/hello" selfhelloWorld;;moduleexports__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:
logobject (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-expressto 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.
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.