Setting up Frontend - community-app

Let's get started!

  1. Ensure you have

Note: On Ubuntu Linux you can use sudo apt-get install npm nodejs-legacy, which avoids the /usr/bin/env: node: No such file or directory problem.

Note that on Linux distributions you'll need to install the Ruby Development package (e.g. sudo dnf install ruby-devel on Fedora), and not just ruby, otherwise bundle install below will fail when it gets to installing ffi which uses native extensions.

  1. Clone this repository to your local filesystem (default branch is 'develop'):

     git clone
  2. To download the dependencies, and be able to build, first install bower & grunt:

     npm install -g bower
     npm install -g grunt-cli

If this fails with npm WARN checkPermissions Missing write access to /usr/local/lib and npm ERR! code EACCES because you are not running npm with sudo as root (which you rightfully really shouldn't!) then use npm config set prefix ~ once before doing npm install. Note that in that case bower and grunt will be installed into ./bin/bower instead of /usr/local/bin, and so you need to prefix it in the usages below.

  1. Next pull the runtime and build time dependencies by running bower, npm, and gem commands on the project root folder:

     bower install
     npm install
     gem install bundler
     bundle install

    If you used npm config set prefix ~, then you have to use ./bin/bower install instead of bower install.

  2. To preview the app, run the following command on the project root folder:

     grunt serve

    If you used npm config set prefix ~, then you have to use ./bin/grunt serve instead of grunt serve.

    or open the 'index.html' file in FIREFOX browser

    Note: If you see a warning similar to the one shown below on running grunt serve , try increasing the number of open files limit as per the suggestions at

     Waiting...Warning: EMFILE, too many open files
  3. You can use these credentials to log in:

     Username: mifos
     Password: password

You are done.

Last updated