How resocoder/flutter-tdd-clean-architecture-course works
Project type and purpose
• This is a cross-platform mobile application built with Flutter, following Uncle Bob’s Clean Architecture and Test-Driven Development (TDD) principles.
• The app’s feature is “Number Trivia”: fetch concrete or random trivia about numbers from a remote API, cache it locally, and display it in the UI.
File structure
• Top-level folders:
• android/ios: platform-specific project files & native integration (Gradle, Xcode).
• lib/: main Dart code, organized by layers.
• test/: unit and widget tests, mirroring lib/ structure.
• Clean Architecture layers under lib/:
• core/: reusable utilities (error handling, network info, input conversion, base UseCase).
• features/number_trivia/: feature module, subdivided into:
– data/: concrete implementation of data retrieval – remote and local data sources, DTO models, repository impl.
– domain/: business rules – Entities, Repositories (abstract), UseCases.
– presentation/: UI layer – BLoC, events, states, pages, widgets.
• injection_container.dart: dependency injection (GetIt) setup.
• main.dart: entry point, initializes DI and runs the Flutter app.
• Configuration files:
• pubspec.yaml: dependencies (http, shared_preferences, get_it, flutter_bloc…).
README for additional insights
• README title: “TDD Clean Architecture for Flutter” with link to an architecture proposal image.
• Suggests a four-layered architecture: Presentation → Domain → Data → External.
– Labels: “Presentation Layer”, “Domain Layer”, “Data Layer”, “External”.
– Components: NumberTriviaPage, NumberTriviaBloc, UseCases, Repository Interface, Repository Impl, RemoteDataSource, LocalDataSource, Models, Entities.
• Business logic (green)
• Data sources (orange)
• External (gray)