How titomitto/counter-mini works
Project type and purpose
• This is a cross-platform Flutter application (“Counter Mini”) implementing Clean Architecture, BDD, TDD and Riverpod state management.
• Its purpose is to serve as a teaching and reference app: a counter with increment, decrement, reset (with confirmation), limits, history tracking and validation.
File structure
• Top-level directories:
• android, ios, linux, macos, windows, web – platform integration code generated by Flutter
• lib – the heart of the application, subdivided into “app” and “counter” modules
• test – Gherkin (feature files) and Dart tests
• config files: pubspec.yaml, env.json, analysis_options.yaml, build.yaml
• In lib/app:
• app.dart – root widget
• config/go_router.dart(.g.dart) – routing configuration
• data – shared data definitions
• ui – potential shared UI components
• In lib/counter:
• config/counter_routes.dart(.g.dart) – feature-specific routing
• counter.dart – domain entity and use-cases definitions
• data – repository implementations or in-memory data storage
• ui/notifiers – Riverpod state-notifiers (counter logic)
• ui/screens – Flutter screens (presentation layer)
README for additional insights
• Emphasis on:
• Clean Architecture (layered separation)
• BDD (Gherkin feature files under test/counter/*.feature)
• TDD with unit/widget/integration tests
• Riverpod for state management