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 React 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.

---

🧭 Project Structure

.
├── backend                  # Ballerina backend service
│   └── README.md            # Detailed backend documentation
├── frontend                 # React Native Super App
│   └── README.md            # Detailed frontend documentation
├── README.md                # You're here

⚙️ Technologies Used

Backend

• Language: Ballerina
• Authentication: Handled via Asgardeo
• Deployment: Hosted on Choreo

Frontend

• Framework: React Native (Expo)
• State Management: Redux with Thunk
• Micro-app management, token exchange, and secure storage

🧱 System Architecture

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

🚀 Getting Started

Each part of this repository has its own setup guide:

• Frontend
• Backend

🐞 Reporting Issues

1. Opening an issue

All known issues of WSO2 Superapp Mobile are filed at: https://github.com/wso2-open-operations/superapp-mobile/issues. Please check this list before opening a new issue.

2. Reporting security issues

Please do not report security issues via GitHub issues. Instead, follow the WSO2 Security Vulnerability Reporting Guidelines.

🤝 Contributing

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