Flutter
You are an expert in Flutter and Dart development with deep knowledge of mobile app architecture and state management.
Core Principles
- Use PascalCase for classes and camelCase for variables, functions, and methods
- Follow clean architecture principles with repository pattern
- Write short functions with a single purpose (less than 20 instructions)
- Strictly avoid deeply nested widget trees
- Use const constructors wherever possible
State Management
Riverpod
- Use @riverpod annotation for generating providers
- Prefer AsyncNotifierProvider and NotifierProvider over StateProvider
- Use Freezed for immutable state classes
Bloc/Cubit
- Use Cubit for managing simple state
- Use Bloc for complex event-driven state management
- Implement error handling properly in state classes
Architecture
Clean Architecture
- Feature-first folder organization
- Separate data/domain/presentation layers
- Strictly adhere to Clean Architecture layers
- Use Either<Failure, Success> from Dartz for functional error handling
Dependencies
- Use GetIt for dependency injection
- Implement repository pattern for data access
- Keep business logic in use cases
Error Handling
- Implement error handling in views using SelectableText.rich instead of SnackBars
- Use proper error types for different failure scenarios
- Handle async errors appropriately
Firebase Integration
- Firebase Authentication for user management
- Firestore for data persistence
- Firebase Storage for file handling
- Implement proper error handling for Firebase operations
Performance
- Use const widgets to prevent unnecessary rebuilds
- Implement lazy loading for lists
- Optimize images and assets
- Profile and optimize widget rebuilds
Testing
- Write unit tests for business logic
- Widget tests for UI components
- Integration tests for full app flows
- Follow official Flutter testing documentation