> For the complete documentation index, see [llms.txt](https://docs.mifos.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mifos.org/mifosx/developer-space/setting-up-dev-environment/setting-up-frontend-community-app.md).

# Setting up Frontend - community-app

## Let's get started!

1. Ensure you have
   * `npm` installed - goto <http://nodejs.org/download/> to download the installer for your OS.
   * `ruby` installed - goto <https://www.ruby-lang.org/en/documentation/installation/> to download the latest version of ruby.

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 https://github.com/openMF/community-app.git
   ```
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 <http://stackoverflow.com/questions/34588/how-do-i-change-the-number-of-open-files-limit-in-linux/>

   ```
    Waiting...Warning: EMFILE, too many open files

   ```
3. You can use these credentials to log in:

   ```
    Username: mifos
    Password: password
   ```

You are done.