Differences

This shows you the differences between two versions of the page.

--- arcs.js:installing_arcs [2014/12/23 14:46]
didier
+++ arcs.js:installing_arcs [2015/04/19 07:33] (current)
didier
@@ Line 1: / Line 1: @@
 ====== Installing ARCS.js ======
+**ARCS.js** is in its early stage of development. Therefore, the software is delivered for a development setup.
 ===== Dependencies =====
-**ARCS.js** has several dependencies depending whether it is used for development or for deployment.
+To run ARCS.js, you will have to setup an environment with several dependencies:
+  * [[https://nodejs.org/|Node.js]]: command-line javascript engine and tools;
+  * [[http://git-scm.com/|Git]]: a distributed version control system required by some tools.
+===== Environment setup =====
+**Node.js** comes with a package manager that will help us to set up tools required to build ARCS.js and deploy it. Two tools will be needed:
+  * [[http://gruntjs.com/|Grunt]]: a task runner that will automate building steps;
+  * [[http://bower.io/|Bower]]: a package manager intended to the client side, that is to say to the web browser.
+We will install these tools using **npm**, the package manager installed with node and download all remaining node packages needed by typing these three lines (in any *NIX platform):
+<code>
+sudo npm install -g grunt-cli
+sudo npm install -g bower
+npm install
+</code>
+Under windows, you can just drop the ''sudo'' part of the commands.
+Once this first step is completed, to setup the environment, two more actions will be needed:
+  - Install web dependencies;
+  - Build an operational version of ARCS.js.
+This is performed using grunt:
+<code>
+grunt bower
+grunt
+</code>
+If everything happened free of errors, then **ARCS.js** should work out of the box. You can launch any example from the ''tests'' directory.