{"id":25144499,"url":"https://github.com/openmf/web-app","last_synced_at":"2025-05-14T22:07:32.713Z","repository":{"id":37819595,"uuid":"134337850","full_name":"openMF/web-app","owner":"openMF","description":"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.","archived":false,"fork":false,"pushed_at":"2025-05-14T02:37:20.000Z","size":363008,"stargazers_count":278,"open_issues_count":7,"forks_count":652,"subscribers_count":41,"default_branch":"dev","last_synced_at":"2025-05-14T03:58:55.278Z","etag":null,"topics":["angular-7","angular-material-7","hacktoberfest","mifosx-platform","scss","typescript"],"latest_commit_sha":null,"homepage":"https://sandbox.mifos.community","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openMF.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-05-22T00:04:59.000Z","updated_at":"2025-05-14T02:32:37.000Z","dependencies_parsed_at":"2022-07-14T04:30:37.247Z","dependency_job_id":"441226dd-d7bb-4081-865c-5967e2e47d41","html_url":"https://github.com/openMF/web-app","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Fweb-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Fweb-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Fweb-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Fweb-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openMF","download_url":"https://codeload.github.com/openMF/web-app/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254235696,"owners_count":22036963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular-7","angular-material-7","hacktoberfest","mifosx-platform","scss","typescript"],"created_at":"2025-02-08T19:46:32.736Z","updated_at":"2025-05-14T22:07:27.699Z","avatar_url":"https://github.com/openMF.png","language":"TypeScript","readme":"# Mifos X Web App ![build](https://github.com/openMF/web-app/actions/workflows/build.yml/badge.svg)\n\n## Overview\n\nMifos 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.\n\n**Technologies Used:**\n\n- HTML5, SCSS, and TypeScript\n- Angular framework\n- Angular Material components\n\n## Quick Links\n\n- [Live Demo](https://sandbox.mifos.community/#/login) (Updated nightly)\n- [GitHub Repository](https://github.com/openMF/web-app)\n- [TestRigor](https://app.testrigor.com/public/X3THbQd9nxLMxkdPu)\n- [Slack Channel](https://app.slack.com/client/T0F5GHE8Y/CJJGJLN10)\n- [Jira Board of Mifos](https://mifosforge.jira.com/jira/your-work)\n- [Jira Board of Mifos Web App Project](https://mifosforge.jira.com/jira/software/c/projects/WEB/boards/62)\n\n## Installation Guide\n\n### Prerequisites for All Methods\n\n- Git: [Download here](https://git-scm.com/downloads)\n- Mifos X Backend (Fineract) - **Required before running the web app**\n\n### Backend Setup (REQUIRED FIRST)\n\nBefore installing the web app, you need to set up the Fineract backend server:\n\n1. **Choose ONE of these backend options:**\n\n   - **Option A: Use existing remote server**\n\n     - Use the sandbox at `https://sandbox.mifos.community`\n     - Use the demo at `https://demo.mifos.community`\n     - Configure to your server by updating API URLs in environment files\n\n   - **Option B: Install local Fineract server**\n\n     [Installation Guide](https://github.com/apache/fineract?tab=readme-ov-file#instructions-how-to-run-for-local-development)\n\n   - **Option C: Docker Compose for full stack**\n     - See Docker Compose section below for one-step backend+frontend setup\n\n2. **Configure environment files to point to your backend:**\n   - Update `environments/environment.ts` (development)\n   - Update `environments/environment.prod.ts` (production)\n   - Change OAuth2 settings if needed (disabled by default)\n\n### Frontend Setup (Web App)\n\nChoose ONE of the following methods to install the web app:\n\n#### Method 1: Manual Installation\n\n1. Install Node.js: [Download here](https://nodejs.org/en/download/)\n2. Install Angular CLI:\n   ```\n   npm install -g @angular/cli@16.0.2\n   ```\n3. Clone the repository:\n   ```\n   git clone https://github.com/openMF/web-app.git\n   ```\n   For Windows:\n   ```\n   git clone https://github.com/openMF/web-app.git --config core.autocrlf=input\n   ```\n4. Navigate to the project directory:\n   ```\n   cd web-app\n   ```\n5. Install dependencies:\n   ```\n   npm install\n   ```\n6. Start the development server:\n   ```\n   ng serve\n   ```\n7. Access the application at `http://localhost:4200/`\n\n#### Method 2: Docker Container Only\n\n1. Build the Docker image:\n   ```\n   docker build -t openmf/web-app:latest .\n   ```\n2. Run the container:\n   ```\n   docker run -d -p 4200:80 openmf/web-app:latest\n   ```\n3. Access the application at `http://localhost:4200/`\n\n#### Method 3: Docker Compose (Frontend + Backend)\n\nThis sets up both the Mifos X Web App and Fineract backend:\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/openMF/web-app.git\n   cd web-app\n   ```\n   For Windows:\n   ```\n   git clone https://github.com/openMF/web-app.git --config core.autocrlf=input\n   cd web-app\n   ```\n2. Start Docker Compose:\n   ```\n   docker compose up -d\n   ```\n3. Access the application at `http://localhost:4200/`\n\n## Default Login Credentials\n\nWhen using the development server with basic authentication:\n\n- **Username:** mifos\n- **Password:** password\n\n**Important:** Do not alter these credentials.\n\n## Development Commands\n\n- **Serve application:** `ng serve`\n- **Generate new component:** `ng generate component component-name`\n- **Build for production:** `ng build --configuration production` or `npm run build:prod`\n- **Get Angular CLI help:** `ng help`\n\n## Configuration Options\n\n### Environment Variables for Docker\n\nAll these environment variables can be set when using Docker or Docker Compose:\n\n#### Fineract Backend Settings\n\n| Variable                             | Description                                                          | Default Value                                                                       |\n| ------------------------------------ | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |\n| FINERACT_API_URLS                    | Fineract server list                                                 | https://sandbox.mifos.community,https://demo.mifos.community,https://localhost:8443 |\n| FINERACT_API_URL                     | Default Fineract server                                              | https://localhost:8443                                                              |\n| FINERACT_PLATFORM_TENANT_IDENTIFIER  | Default tenant identifier (must align with Fineract `tenants` table) | default                                                                             |\n| FINERACT_PLATFORM_TENANTS_IDENTIFIER | Tenant identifier list (must align with Fineract `tenants` table)    | -                                                                                   |\n\n#### Language Settings (i18n)\n\n| Variable                  | Description                 | Default Value                                                           |\n| ------------------------- | --------------------------- | ----------------------------------------------------------------------- |\n| MIFOS_DEFAULT_LANGUAGE    | Default language            | en-US                                                                   |\n| MIFOS_SUPPORTED_LANGUAGES | List of supported languages | cs-CS,de-DE,en-US,es-MX,fr-FR,it-IT,ko-KO,lt-LT,lv-LV,ne-NE,pt-PT,sw-SW |\n\nAvailable languages:\n\n| Language   | Code | File       |\n| ---------- | ---- | ---------- |\n| Czech      | cs   | cs-CS.json |\n| German     | de   | de-DE.json |\n| English    | en   | en-US.json |\n| Spanish    | es   | es-MX.json |\n| French     | fr   | fr-FR.json |\n| Italian    | it   | it-IT.json |\n| Korean     | ko   | ko-KO.json |\n| Lithuanian | li   | li-LI.json |\n| Latvian    | lv   | lv-LV.json |\n| Nepali     | ne   | ne-NE.json |\n| Portuguese | pt   | pt-PT.json |\n| Swahili    | sw   | sw-SW.json |\n\n#### Session \u0026 Performance Settings\n\n| Variable                          | Description                                          | Default Value |\n| --------------------------------- | ---------------------------------------------------- | ------------- |\n| MIFOS_SESSION_IDLE_TIMEOUT        | Session timeout in milliseconds                      | 300000        |\n| MIFOS_PRELOAD_CLIENTS             | Whether to preload clients in Clients view           | true          |\n| MIFOS_DEFAULT_CHAR_DELIMITER      | Character delimiter for CSV exports                  | ,             |\n| MIFOS_WAIT_TIME_FOR_NOTIFICATIONS | Wait time in seconds for reading notifications       | 60            |\n| MIFOS_WAIT_TIME_FOR_CATCHUP       | Wait time in seconds for reading COB Catch-Up status | 30            |\n| MIFOS_MIN_PASSWORD_LENGTH         | WMinimum length for user passwords                   | 12            |\n\n#### UI Display Settings\n\n| Variable                      | Description                           | Default Value |\n| ----------------------------- | ------------------------------------- | ------------- |\n| MIFOS_DISPLAY_TENANT_SELECTOR | Display tenant selector in Login view | true          |\n| MIFOS_DISPLAY_BACKEND_INFO    | Display backend info in footer        | true          |\n\nFor more detailed configuration options, refer to the `env.sample` file in the root directory of the project.\n\n## Releases\n\n### 1.0.0 (Tag: 1.0.0-fineract1.11)\n\nThis is the first official release of the Mifos X web application:\n\n- Developed for Fineract 1.11\n- No Self Service area\n- GLIM support limited\n- JLG not yet supported\n- Surveys not yet supported\n\n## Contributing\n\nWe welcome contributions! Please read our [contribution guidelines](./CONTRIBUTING.md) before submitting pull requests.\n\n## Related Projects\n\n[Apache Fineract](https://github.com/apache/fineract) - Apache Fineract provides open APIs and affordable core banking solution for financial institutions and is the backend for all UIs of the Mifos.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmf%2Fweb-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenmf%2Fweb-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmf%2Fweb-app/lists"}