Flutter Cursor Rules Template

---
description: "Widget Structure"
alwaysApply: false
---
- Use composition over inheritance — prefer StatelessWidget and StatefulWidget.
- Use    spaces for indentation.
- Use camelCase for variables and methods.
- Extract reusable widgets into separate files.
- Use const constructors for compile-time constant widgets.
- Keep build methods clean — extract complex UI into helper methods.

---
description: "State Management"
alwaysApply: false
---
- Use setState for simple local state within a single widget.
- Use Provider or Riverpod for dependency injection and state propagation.
- Use Bloc/Cubit for complex business logic with event-driven patterns.
- Keep business logic out of widgets — use controllers or blocs.
- Use ValueNotifier and ValueListenableBuilder for single-value state.
- Avoid rebuilding the entire widget tree — use const and selective rebuilds.

---
description: "Layout & Styling"
alwaysApply: false
---
- Use layout widgets (Row, Column, Stack, Expanded, Flexible).
- Use SizedBox and Spacer for spacing — avoid hardcoded padding.
- Use MediaQuery and LayoutBuilder for responsive layouts.
- Use Theme and ThemeData for consistent styling.
- Use Theme.of(context) to access theme values.
- Define text styles, colors, and spacing in a centralized theme.

---
description: "Navigation & Routing"
alwaysApply: false
---
- Use GoRouter for declarative routing with deep linking.
- Use Navigator 2.0 patterns for complex navigation.
- Pass arguments with typed route parameters.
- Use named routes for clarity and maintainability.
- Handle back navigation with proper state management.
- Use route guards for authentication flows.