Setting up Frontend - community-app

Let's get started!

  1. 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. 1.
    Clone this repository to your local filesystem (default branch is 'develop'):
    1
    git clone https://github.com/openMF/community-app.git
    Copied!
  2. 2.
    To download the dependencies, and be able to build, first install bower & grunt:
    1
    npm install -g bower
    2
    npm install -g grunt-cli
    Copied!
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. 1.
    Next pull the runtime and build time dependencies by running bower, npm, and gem commands on the project root folder:
    1
    bower install
    Copied!
    1
    npm install
    Copied!
    1
    gem install bundler
    Copied!
    1
    bundle install
    Copied!
    If you used npm config set prefix ~, then you have to use ./bin/bower install instead of bower install.
  2. 2.
    To preview the app, run the following command on the project root folder:
    1
    grunt serve
    Copied!
    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 http://stackoverflow.com/questions/34588/how-do-i-change-the-number-of-open-files-limit-in-linux/
    1
    Waiting...Warning: EMFILE, too many open files
    2
    Copied!
  3. 3.
    You can use these credentials to log in:
    1
    Username: mifos
    2
    Password: password
    Copied!
You are done.
Last modified 1yr ago
Copy link