Super App Mobile

This open source project provides a unified platform powered by micro app architecture, allowing you to seamlessly integrate multiple applications within a single container.

With this approach, you can deploy multiple Web apps inside one super app while customizing its functionalities to fit your specific requirements.

This repository serves as the foundation for hosting multiple micro-apps with seamless authentication, integration, and centralized management.

---

📚 View Complete Documentation - Deployment guides, API references, and architecture details

🧭 Project Structure

.
├── backend-services/         # Go microservices for SuperApp backend
│   ├── core/                 # Main API service
│   ├── token-service/        # OAuth2/JWT service
│   └── README.md             
├── docs/                     # Documentation (MkDocs)
├── frontend/                 # React Native (Expo) mobile app
├── observability/            # Monitoring stack (Prometheus, Grafana, Jaeger)
├── sample-microapps/         # Example microapps for demonstration
├── superapp-admin-portal/    # React admin web portal
├── resources/                # Images, diagrams, and assets
├── LICENSE                   # Apache 2.0 license
├── mkdocs.yml                # Documentation site configuration
├── package.json              # Root package configuration
├── issue_template.md         # GitHub issue template
└── pull_request_template.md  # GitHub pull request template

⚙️ Technologies Used

Backend

• Language: Go

Frontend

• Framework: React Native (Expo)
• State Management: Redux Toolkit + Redux Persist

Authentication

• External identity provider (OIDC/OAuth2 compatible)

🧱 System Architecture

Here’s a high-level view of the flow:

Key Concepts

SuperApp vs MicroApps

• SuperApp: The main container application that manages authentication, navigation, and micro-app lifecycle
• MicroApps: Individual web applications loaded in WebViews, each serving specific functionality
• Bridge: Communication layer between SuperApp and MicroApps (see frontend/docs/BRIDGE_GUIDE.md)

🚀 Getting Started

To get up and running quickly, follow the step-by-step guide in our documentation:

👉 Getting Started Guide

This guide covers prerequisites, setup instructions, and how to launch the Super App Mobile project locally.

🐞 Reporting Issues

Opening an issue

All known issues of Open Super App Mobile are filed at: https://github.com/LSFLK/superapp-mobile/issues. Please check this list before opening a new issue.

Next steps & future improvements

Read the planned enhancements and longer-term tasks in FUTURE_IMPROVEMENTS.md.

🤝 Contributing

If you are planning on contributing to the development efforts of Open Superapp Mobile, you can do so by checking out the latest development version. The main branch holds the latest unreleased source code.