flutter-riverpod-architecture

# Flutter + Riverpod Clean Architecture

## Overview

This skill provides architectural patterns and rules for building Flutter applications using Clean Architecture with Riverpod for state management. Follow these patterns to maintain clear layer boundaries, testability, and scalability.

## Architecture Layers

```
┌─────────────────────────────────────────┐
│           Presentation Layer            │  Flutter UI, Widgets, Routing
├─────────────────────────────────────────┤
│           Application Layer             │  Riverpod Providers, State Management
├─────────────────────────────────────────┤
│              Data Layer                 │  Repositories, External APIs
├─────────────────────────────────────────┤
│             Domain Layer                │  Entities, Value Objects, Business Rules
└─────────────────────────────────────────┘
```

## Layer Dependency Rules

| Layer | Can Depend On | Cannot Depend On |
|-------|---------------|------------------|
| **Domain** | Nothing (pure Dart) | Flutter, Riverpod, Firebase, any SDK |
| **Data** | Domain | Flutter, Riverpod, Presentation |
| **Application** | Domain, Data | Flutter UI classes |
| **Presentation** | Application, Domain | Data (direct access) |

## Quick Reference

| Layer | Primary Purpose | Key Technology |
|-------|-----------------|----------------|
| Domain | Business entities, Value Objects | Freezed, pure Dart |
| Data | Repository implementations, API calls | Firebase, HTTP clients |
| Application | State management, Provider definitions | Riverpod, AsyncNotifier |
| Presentation | UI components, routing | ConsumerWidget, go_router |

## Layer References

- `references/domain-layer.md` - Freezed entities, Value Objects, immutable data
- `references/data-layer.md` - Repository pattern, dependency injection
- `references/application-layer.md` - Riverpod providers, AsyncNotifier pattern
- `references/presentation-layer.md` - ConsumerWidget, type-safe routing
- `references/ui-patterns.md` - Widget