Skip to content

Mifos X Web App is the Web-UI component of Mifos X. It currently uses Apache Fineract as the backend and leverages the popular Angular framework. Main Branch is the latest Stable Release, Dev should be used for all development ahead of release.

License

Notifications You must be signed in to change notification settings

RehanMehtaIND/web-app

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,818 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mifos X Web App build

Overview

Mifos X Web App is a modern single-page application (SPA) built on top of the Mifos X platform for financial inclusion. It serves as the default web interface for the Mifos user community.

Technologies Used:

  • HTML5, SCSS, and TypeScript
  • Angular framework
  • Angular Material components

Installation Guide

Prerequisites for All Methods

  • Git: Download here
  • Mifos X Backend (Fineract) - Required before running the web app

Backend Setup (REQUIRED FIRST)

  • For backend, either take the shortcut of using (/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --disable-web-security --user-data-dir="/tmp/ChromeDev") for testing.
  • Else, try using docker if you have a PC/Laptop with good specifications.

Frontend Setup (Web App)

Preferred Method: Manual Installation

  1. Install Node.js: Download here
  2. Install Angular CLI:
    npm install -g @angular/cli@16.0.2
    
  3. Clone the repository:
    git clone https://github.com/openMF/web-app.git
    
    For Windows:
    git clone https://github.com/openMF/web-app.git --config core.autocrlf=input
    
  4. Navigate to the project directory:
    cd web-app
    
  5. Install dependencies:
    npm install
    
  6. Start the development server:
    ng serve
    
  7. Access the application at http://localhost:4200/

Default Login Credentials

When using the development server with basic authentication:

  • Username: mifos
  • Password: password

Important: Do not alter these credentials.

Update Log

Ongoing documentation of daily progress, research, and implementation efforts.

Timeline 16 November - 2 December

Show Details

Reviewed all relevant documentation and requirements.

Refined and finalized the Product Requirement Document (PRD).

Completed the viva on 21 November.

22 November
Show Details

Identified viable closed PRs related to our feature scope.

Tagged them for deeper analysis.

23 November
Show Details

Analyzed shortlisted PRs in detail.

Reviewed implementation decisions, change sets, and architectural impact.

24 November
Show Merged PRs Reviewed

Focused on merged pull requests relevant to the project.

Reviewed:

#2790 — WEB-369-fix(oauth2): Replace localStorage with sessionStorage in callback component openMF#2790

#2798 — Revert: WEB-394-fix — Remove direct JSON.parse usages, restore previous behavior openMF#2798

#2757 — WEB-399-fix(webappcomponent): Add RxJS cleanup & unsubscribe handlers to prevent memory leaks openMF#2757

25 November
Show Details

Fixed all the issues with launching through client side AGAIN.

Reviewed implementation decisions, change sets, and architectural impact again.

26 November
Show Details

Created test changes and pushed data to our Repo.

Planned further changes and started working on them locally.

27 November
Show Details

Rehan finished working on the home page's HTML/CSS and added shortcuts to other pages.

28 November
Show Details

Fixed conflicts with other scripts.

29 November
Show Details

Deepanshu finished his work on merging the dashboard and home components.

30 November & 1 December
Show Details

Fixed conflicts and resolved data-related issues with graphs in Deepanshu’s part.

2 & 3 December
Show Details

Pushed and merged code to the final repo.

About

Mifos X Web App is the Web-UI component of Mifos X. It currently uses Apache Fineract as the backend and leverages the popular Angular framework. Main Branch is the latest Stable Release, Dev should be used for all development ahead of release.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • TypeScript 58.6%
  • HTML 38.6%
  • SCSS 2.7%
  • Other 0.1%