community-app

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

thoughtworker cbcd55e788 tried things		2013-11-27 10:21:04 -06:00
app	broken client controller test- need to fix stubbing	2013-11-23 20:56:27 +05:30
test	tried things	2013-11-27 10:21:04 -06:00
.bowerrc	vertical slicing!	2013-09-13 10:49:03 +05:30
.gitignore	Enhanced .gitignore with few IDEA related exclusions.	2013-11-12 17:27:06 +01:00
.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	.travis.yml, for Node-based JS build (for later)	2013-10-20 09:00:54 +02:00
bower.json	Changed the name from prototype to community-app in bower.json. Also set API_URL_OVERRIDE to true by default to make it easier for newbies to get started	2013-11-18 10:57:35 +05:30
build.gradle	Introduced gradle build with maven plugin for releasing WAR file and bower integration.	2013-11-12 17:31:26 +01:00
Gruntfile.js	Grunt - as proposed by Yeoman. Not yet fully working..	2013-10-20 08:50:28 +02: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	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
package.json	Grunt - as proposed by Yeoman. Not yet fully working..	2013-10-20 08:50:28 +02:00
README.md	Fixed erroneous confusing double HOST in README	2013-11-13 09:40:36 +01:00

README.md

Online Demo

Access the online demo version here

Building from source

Note: Ensure you have npm installed - goto http://nodejs.org/download/ to downloand installer for your OS.
Clone this repository to your local filesystem (default branch in 'master')
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"

Now open the 'index.html' file in FIREFOX browser.
Default username/password: mifos/password. This application will hit the demo server by default.

You are done.

Out of the box, the UI will connect to the mifosng-provider REST API running on the same host/port (API_URL_OVERRIDE === 'false'). If you want to connect to the API running elsewhere, e.g. the https://demo.openmf.org running in the cloud, e.g. so that someone with only JS skills who couldn't be bothered about having to set up the platform back-end locally can work on the UI, modify the constant in community-app\app\scripts\modules\configurations.js as below:

.constant('API_URL_OVERRIDE', 'true')
.constant('HOST','https://demo.openmf.org')
.constant('API_VERSION','/mifosng-provider/api/v1')

Similarly, to connect to a local server running on a different port than the web app on localhost, use:

.constant('API_URL_OVERRIDE', 'true')
.constant('HOST','https://localhost:8443\:8443') // need to escape port number

Later, it may be possible to specify the baseApiUrl as part of the app's URL, watch Issue 199 (help/pull requests most welcome!).

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 the tests

Just open test/SpecRunner.html in the browser.