Loading repository data…
dariomatias-dev / repository
Single-player strategy game built with Flutter. Place barriers on an 11×11 hex grid to surround the cat before it escapes. Features 3 difficulty levels, persistent win/loss tracking, and runs on Android, Web, and Desktop.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Catch the Cat is a single-player strategy game played on an 11×11 hexagonal grid. Each turn the player places one barrier; the CPU then moves the cat one step toward the nearest escape route. The player wins by completely surrounding the cat; the CPU wins if the cat reaches the board's edge.
The game tracks wins and losses across sessions and supports three difficulty levels that affect both the initial board setup and the cat's AI behavior.
| Level | Initial Barriers | Cat Start Position | CPU AI Behavior |
|---|---|---|---|
| Easy | 6 – 10 | Random | Moves to a random empty cell |
| Medium | 9 – 15 | Central region | Follows the shortest escape path |
| Hard | 12 – 16 | Fixed center (5,5) | Maximizes escape distance — picks the blocking cell that increases the cat's escape path the most |
The project applies three complementary patterns:
Feature-First → folder organization by business domain
Clean Arch → explicit dependency rules between layers
MVVM → decoupled UI and presentation logic
Selected from shared topics, language and repository description—not editorial ratings.
ProjetosPDM /
Single-player strategy game built with Flutter. Place barriers on an 11×11 hex grid to surround the cat before it escapes. Features 3 difficulty levels, persistent win/loss tracking, and runs on Android, Web, and Desktop.
65/100 healthData flow inside each feature:
Screen → Provider → ViewModel → Repository (contract) → RepositoryImpl → DataSource
The Domain layer (entities, repositories, services) is pure Dart with zero external dependencies. The UI never touches persistence or AI logic directly.
lib/src/
├── core/
│ ├── providers/ # Global providers (audio, SharedPreferences)
│ ├── services/ # AudioService
│ └── theme/ # App colors and theme
└── features/
└── game/
├── data/ # Repository implementations
├── di/ # Dependency injection (Riverpod providers)
├── domain/
│ ├── entities/ # CellState, Difficulty, GameResult, Position
│ ├── repositories/
│ └── services/ # BoardService (BFS pathfinding), CpuAiService
└── presentation/
├── providers/ # GameProvider (Notifier)
├── screens/ # GameScreen
├── view_models/ # GameStateViewModel
└── widgets/ # Board, cells, header, score panel, status banner
| Technology | Version | Role |
|---|---|---|
| Flutter | 3.44.0 | UI framework |
| Dart SDK | ^3.12.0 | Language |
| flutter_riverpod | 2.6.1 | State management and DI |
| audioplayers | 6.7.0 | Background music and SFX |
| shared_preferences | 2.5.5 | Persistent score storage |
3.44.0 managed via FVM# Clone the repository
git clone https://github.com/dariomatias-dev/catch_the_cat_app.git
# Enter the project directory
cd catch_the_cat_app
# Install the correct Flutter version
fvm install
# Install dependencies
fvm flutter pub get
# Run the app
fvm flutter run
Android · Web · Desktop
Alison Andrade
Dário Matias
José Arthur Almeida