Leafory: A Production-Ready App with Clean Architecture

The Challenge

The challenge for this project was to build a cross-platform mobile application with a focus on creating a clean, scalable, and maintainable architecture, as if it were a long-term project to be worked on by a team. The goal was to go beyond just building features and to demonstrate a professional approach to software engineering.

My Role & The Solution

As the Sole Creator, I handled the entire project lifecycle, from design in Figma to the final, functional application.

The application was architected using Clean Architecture, creating a clear separation between the Presentation, Domain, and Data layers. I also implemented a feature-first folder structure to ensure the codebase remains organized and easy to navigate as it grows.

Key technical implementations include:

• State Management: Utilized BLoC for predictable and structured state management across the app.

• Declarative Routing: Implemented go_router for a robust, route-based navigation system.

• Networking & Local Storage: Used dio for efficient API communication with the Gutendex API and hive_ce to persist user's favorite books locally.

• Unit Testing: Authored unit tests for the Repository and BLoCs using mocktail and bloc_test to ensure code quality, reliability, and prevent regressions.

The Results & The Impact

The result is a high-quality, production-ready Flutter application that successfully demonstrates my ability to apply advanced software architecture principles. This project serves as a strong portfolio piece that highlights my expertise in building applications that are not just functional, but also maintainable, scalable, and thoroughly tested.

The complete source code, documentation, and unit tests are available for review on GitHub.