066eb8f820
Music Creation Page: - Vinyl 3D flip to view lyrics, tonearm animation, glow rotation effect - Circular SVG progress ring, speech bubble feedback, confirm dialog - Playlist modal, free creation input, lyrics formatting optimization - MiniMax API real music generation with SSE streaming progress Backend: - FastAPI proxy server.py for MiniMax API calls - Music + lyrics file persistence to Capybara music/ directory - GET /api/playlist endpoint for auto-building playlist from files UI/UX Refinements: - frontend-design skill compliance across all pages - Glassmorphism effects, modal interactions, scroll tap prevention - iPhone 12 Pro responsive layout (390x844) Flutter Development Preparation: - Installed flutter-expert skill with 6 reference docs - Added 5 Cursor Rules: official Flutter, clean architecture, UI performance, testing, Dart standards Assets: - 9 Capybara music MP3 files + lyrics TXT files - MiniMax API documentation Co-authored-by: Cursor <cursoragent@cursor.com>
74 lines
2.5 KiB
Plaintext
74 lines
2.5 KiB
Plaintext
---
|
|
description: Clean Architecture + Feature-first + BLoC/Riverpod patterns for Flutter features. Apply to feature modules.
|
|
globs: "lib/features/**/*.dart"
|
|
---
|
|
|
|
# Flutter Clean Architecture — Feature-First
|
|
|
|
## Architecture Layers (Dependency Rule: always inward)
|
|
- **Presentation** → Widgets, Screens, BLoC/Cubit, ViewModels
|
|
- **Domain** → Entities, Repository interfaces, Use Cases
|
|
- **Data** → Repository implementations, Data Sources, DTOs/Models
|
|
|
|
## Feature Directory Structure
|
|
```
|
|
lib/features/feature_name/
|
|
├── data/
|
|
│ ├── datasources/ # Remote + Local data sources
|
|
│ ├── models/ # DTOs, data models (with fromJson/toJson)
|
|
│ └── repositories/ # Repository implementations
|
|
├── domain/
|
|
│ ├── entities/ # Pure business objects
|
|
│ ├── repositories/ # Abstract repository interfaces
|
|
│ └── usecases/ # Single-purpose business logic
|
|
└── presentation/
|
|
├── bloc/ # BLoC/Cubit state management
|
|
├── pages/ # Screen widgets
|
|
└── widgets/ # Feature-specific widgets
|
|
```
|
|
|
|
## Use Case Pattern
|
|
```dart
|
|
abstract class UseCase<Type, Params> {
|
|
Future<Either<Failure, Type>> call(Params params);
|
|
}
|
|
```
|
|
|
|
## State Management
|
|
- Use Freezed for immutable state classes and union types.
|
|
- States: initial, loading, loaded(data), error(failure).
|
|
- Use BlocBuilder with buildWhen for optimized rebuilds.
|
|
- Use BlocListener for side effects (navigation, dialogs).
|
|
- Avoid business logic in UI components.
|
|
|
|
## Error Handling
|
|
- Use Either<Failure, Success> from Dartz for functional error handling.
|
|
- Create custom Failure classes per domain.
|
|
- Proper error mapping between layers.
|
|
- User-friendly error messages in presentation layer.
|
|
|
|
## Dependency Injection
|
|
- Use GetIt as service locator.
|
|
- Register dependencies by feature in separate files.
|
|
- Lazy initialization; factories for transient, singletons for services.
|
|
|
|
## Repository Pattern
|
|
- Single source of truth for data.
|
|
- Handle network/cache fallback gracefully.
|
|
- Map data models to domain entities at repository boundary.
|
|
|
|
## Constraints
|
|
### MUST DO
|
|
- Use const constructors wherever possible.
|
|
- Implement proper keys for lists.
|
|
- Follow Material/Cupertino design guidelines.
|
|
- Profile with DevTools, fix jank.
|
|
- Test widgets with flutter_test.
|
|
|
|
### MUST NOT DO
|
|
- Build widgets inside build() method.
|
|
- Mutate state directly (always create new instances).
|
|
- Use setState for app-wide state.
|
|
- Block UI thread with heavy computation (use compute()).
|
|
- Skip const on static widgets.
|