Beyond the MVP: Scaling Flutter for 5 Million+ Users

There is a persistent myth in the mobile development world: “Flutter is great for quick MVPs, but for massive scale, you need to go native.”

At Leenspace, we’ve spent the last few years debunking that notion. Nowhere is this more evident than in our work with Agora Shop—the digital backbone of Intercorp, the largest retailer in Peru. Serving over 5 million users, the app combines supermarkets, pharmacies, and home improvement stores into one "Super App."

When managing a complex retail ecosystem, scalability is both a technical and operational requirement. Here is how we evolved Flutter from a peripheral tool into a high-concurrency gateway.

1. The Evolution: From "Add-to-App" to Full Flutter

The journey didn't start with a blank slate. Initially, the project utilized Flutter Add-to-App, embedding Flutter modules into existing native legacy codebases to prove the framework's value. However, as the vision expanded, so did our technical ambition.

We transitioned from a hybrid approach to a comprehensive, full-Flutter architecture. This evolution unified the developer experience and eliminated the overhead of maintaining multiple bridge layers, allowing us to build a truly seamless "Super App."

2. The "Puzzle" Architecture: Universal vs. App-Specific

We treated the app like a puzzle made of seamless pieces. The core requirement was that modules must be reusable for standalone applications (e.g., a dedicated app for a single store) while functioning perfectly within the Super App.

• Smart Encapsulation: While we prevent "logic leaks" to keep the codebase clean, our architecture is designed for deep customization. Certain modules allow for brand-specific UI/UX overrides or logic shifts without breaking the core engine.
• App-Specific Modules: Not every piece of the puzzle is generic. We maintain a clear distinction between reusable core modules (like payments or auth) and app-specific modules tailored to the unique workflows of a single retail brand.
• Parallel Development: Independent squads work on their specific "puzzle pieces" simultaneously, ensuring that a change in the "Pharmacy" module never causes a regression in the "Supermarket" module.

3. Orchestrating the Monorepo: Melos and Pubspec Workspaces

Managing dozens of independent modules across 5 million users requires heavy-duty orchestration. To keep this massive puzzle organized, we leveraged Melos and pubspec workspaces.

• Melos: This acts as our command center. It allows us to run scripts across all modules simultaneously, handle versioning, and manage complex internal dependencies without the manual headache.
• Pubspec Workspaces: By utilizing the latest workspace features, we streamlined dependency management. This ensures that whether a module is living inside the Super App or a standalone store app, it stays in sync and avoids "dependency hell."

4. High-Performance UI with the Impeller Engine

At 5 million users, performance must be democratic. Your audience is using everything from the latest flagship to five-year-old budget Androids.

We leveraged Flutter’s Impeller rendering engine to eliminate "jank" (stuttering animations). By pre-compiling shaders, we ensured that scrolling through a 20,000-item catalog feels as fluid as a native system app. This technical choice directly impacts conversion—if the app feels fast, the user stays in the funnel.

5. Quality Assurance: The Zero-Failure Pipeline

When an app serves millions, a "small bug" can affect tens of thousands of people in minutes. We moved beyond simple testing into a multi-layered QA strategy:

• Unit Tests at Every Level: We don't just test the big stuff. From individual UI widgets to the deepest layers of business logic (BLoC), every component is backed by unit tests to ensure stability at the granular level.
• Automated Regression Suites: Our "safety net" ensures that as new modules are added or customized, the core user experience remains untouched.
• Agent Reviews & Pipeline Checks: Every pull request undergoes rigorous automated pipeline checks and peer/agent reviews. No code reaches production without passing through a gauntlet of static analysis, linting, and manual quality gates.

The Result: A Scalable E-commerce Ecosystem

The success of Agora Shop proves that Flutter is an enterprise-ready powerhouse. By evolving from "Add-to-App" to a modular, customizable puzzle-based architecture, Leenspace helped transform a complex retail vision into a resilient reality for millions of users.

Ready to scale your product to millions of users? 

Let’s build something BIG together.