mirror of https://github.com/openMF/community-app.git synced 2026-02-06 13:51:55 +00:00

This is the default web application built on top of the Apache Fineract platform. The Mifos X Web App (formerly called Community App) is maintained by the Mifos Initiative as a reference solution for the financial inclusion community. It is a Single-Page App (SPA) written in web standard technologies like JavaScript, CSS and HTML5. It leverages common popular frameworks/libraries such as AngularJS 1.5, Bootstrap and Font Awesome

hacktoberfest

Go to file

pkt77 f6289ccc66 Retain Search Criteria (and formatting)		2014-12-11 10:57:46 -05:00
app	Retain Search Criteria (and formatting)	2014-12-11 10:57:46 -05:00
test	Retain Search Criteria (and formatting)	2014-12-11 10:57:46 -05:00
.bowerrc	vertical slicing!	2013-09-13 10:49:03 +05:30
.gitignore	updated gitignore with custom_files folder	2014-05-21 19:09:37 +05:30
.jshintrc	.jshintrc ignore indentation issues - we'd have bigger fish to fry, first	2013-10-20 08:55:00 +02:00
.project	Eclipse .project to be able to easily File > Open in E	2013-11-12 11:09:24 +01:00
.travis.yml	chelsea and stacey's work around travis email and readme updates	2013-12-20 02:18:37 +05:30
bower.json	MIFOSX-1444 downgrading angular bootstrap	2014-09-28 21:17:53 -07:00
build.gradle	Fixed running 'bower install' during gradle install WAR build (it didn't	2013-12-06 20:36:21 +01:00
Contributing.md	adds unit test documentation	2013-12-03 16:07:11 -06:00
Gruntfile.js	Didn't mean to check in my local gruntfile change!	2014-09-01 14:05:50 -04:00
karma-e2e.conf.js	Grunt Karm - as proposed by Yeoman (forgot to commit earlier). Not really working as it should, yet	2013-10-20 09:13:24 +02:00
karma.conf.js	Fixed warning in karma test runner	2014-07-18 00:03:27 +10:00
package.json	Wire in karma-coverage which gets run as part of grunt "test" task	2014-03-26 22:54:39 -07:00
README.md	Doc update re. Node.js set-up on Ubuntu Linux	2014-12-03 22:22:10 +01:00

README.md

MifosX Community App

This is the default web application built on top of the MifosX platform for the mifos user community. It is a Single-Page App (SPA) written in web standard technologies like JavaScript, CSS and HTML5. It leverages common popular frameworks/libraries such as AngularJS, Bootstrap and Font Awesome.

Build Status

Travis

Online Demo

Access the online demo version here

Building from source

Note: Ensure you have npm installed - goto http://nodejs.org/download/ to download installer for your OS. On Ubuntu Linux you can use 'sudo apt-get install npm nodejs-legacy' (nodejs-legacy is required to avoid the ""/usr/bin/env: node: No such file or directory" problem).
Clone this repository to your local filesystem (default branch is 'develop')
To download the dependencies, and be able to build, first install bower & grunt
```
 npm install -g bower
 npm install -g grunt-cli
```
Next pull the runtime and build time dependencies by running bower and npm install commands on the project root folder
```
 bower install
```
```
 npm install 
```
To preview the app, run the following command on the project root folder
```
 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
```
Default username/password: mifos/password. This application will hit the demo server by default.

You are done.

Connecting to a MifosX Platform running on a different host:

By default, when the app is running from the local filesystem, it will connect to the platform (mifosng-provider REST API) deployed on demo.openmf.org.

The app connects to the platform running on the same host/port when deployed on a server.

If you want to connect to the API running elsewhere, then append the baseApiUrl and tenantIdentifier as query parameters,

e.g. http://localhost:9000/?baseApiUrl=https://localhost:8443&tenantIdentifier=default

e.g. http://localhost:9000/?baseApiUrl=https://demo.openmf.org&tenantIdentifier=default

Adding dependencies

You can also add more dependencies on bower.json. You can search for them in http://sindresorhus.com/bower-components/ or even:

bower search <package>

Running grunt tasks

Grunt tasks are used to automate repetitive tasks like minification, compilation, unit testing, linting, production builds, etc

Following are the tasks integrated.

Validate JS and HTML files

Validate the JS files to detect errors and potential problems in JavaScript code. All errors output will be written to jshint-log.xml file which get created under project base directory. Checks the markup validity of HTML files. All errors output will be written to console.

grunt validate

Build

Build the code for production deployment.

grunt prod

Serve

Use this for development. Start a static server and open the project in the default browser. The application will hit the demo server.

grunt serve

Running the tests

Just open test/SpecRunner.html in the browser.

Contribution guidelines

Please read the contribution guidelines