Flutter TDD Clean Architecture E-Commerce App – EShop

Product Name Screen Shot

Welcome to the Flutter-TDD-Clean-Architecture-E-Commerce-App GitHub repository! This project is a showcase of modern mobile app development practices, leveraging the power of Flutter, Test-Driven Development (TDD), Clean Architecture, and the BLoC (Business Logic Component) package. Built using the latest version of Flutter 3, this E-Commerce application exemplifies best practices for building scalable, maintainable, and efficient Flutter apps.

Key Features:

  • Test-Driven Development (TDD): This project emphasizes the importance of writing tests before writing the actual code. It ensures that the application’s logic is thoroughly tested, enhancing reliability and maintainability.
  • Clean Architecture: The app follows a clean and modular architecture that separates concerns into different layers: Presentation, Domain, and Data. This architecture promotes code reusability and makes it easier to adapt to changes in the future.
  • BLoC State Management: The app utilizes the BLoC pattern for state management. BLoC helps manage the flow of data and business logic in a clean and reactive manner, improving overall app performance.
  • E-Commerce Functionality: The app showcases a variety of E-Commerce features, such as product browsing, searching, cart and purchasing. Users can explore products, add them to their cart, and complete transactions seamlessly.

Feature UseCases
Product Get Product UseCase
Category Get Cached Category UseCaseGet Remote Category UseCaseFilter Category UseCase
Cart Get Cached Cart UseCaseGet Remote Cart UseCaseAdd Cart Item UseCaseSync Cart UseCase
User Get Cached User UseCaseSignIn UseCaseSignUp UseCaseSignOut UseCase
Delivery Info Get Cached Delivery Info UseCaseGet Remote Delivery Info UseCaseAdd Delivery Info UseCase
Order Get Orders UseCaseAdd Order UseCase

Demo Sample


We welcome contributions from the Flutter community to make this project even better. Whether you are interested in adding new features, fixing bugs, or improving documentation, your contributions are highly appreciated. Please refer to the contribution guidelines in the repository for more details on how to get involved.

Getting Started

To get started with this project, follow the instructions in the README to set up your development environment and run the app locally. You can also explore the project’s architecture, tests, and documentation to gain insights into building robust Flutter apps.

We hope this Flutter-TDD-Clean-Architecture-E-Commerce-App serves as a valuable resource for both Flutter enthusiasts and developers looking to learn about TDD, clean architecture, and BLoC in the context of mobile app development. Happy coding!


  1. Clone the repo
    git clone https://github.com/Sameera-Perera/Flutter-TDD-Clean-Architecture-E-Commerce-App.git
  2. Install packages
    flutter pub get
  3. Run app
    flutter run lib/main.dart
  4. Run test
    flutter test

For help getting started with Flutter, view our online documentation.


Distributed under the MIT License. See LICENSE for more information.


View Github