Flutter Development Guidelines

Grundlegende Best-Practice-Regel für sauberen, wartbaren Flutter-Code in Cursor.

Original-Beschreibung der Autoren: Cursor rules for Flutter development with MVVM architecture, Riverpod state management, Material widgets, and Dart style guidelines.

Die Regel

---
description: "Cursor rules for Flutter development with MVVM architecture, Riverpod state management, Material widgets, and Dart style guidelines."
globs: **/*.dart
alwaysApply: false
---
### Code style and structure
- Write concise and efficient source code.
- Strive for source code that is easy to read and maintain, and provide accurate examples.
- Avoid duplication of code: modularise widgets and functions into reusable components.
- Use descriptive variable names: use names with auxiliary verbs such as isLoading, hasError.

### Directory structure under /lib.
- /lib/models/: data models and type definitions (Models)
- /lib/viewmodels/: state management and business logic (ViewModel)
- /lib/views/widgets/: reusable widgets (View)
- /lib/views/screens/: per-screen widgets (View)
- /lib/services/: service classes for API calls and data access
- /lib/utils/: helper functions and constants

### Naming conventions
- Directories and files: use snakeCase (e.g. auth_wizard.dart).
- UpperCamelCase: use for class names/enumerations/typedefs/type parameters, etc.
- LowerCamelCase: used for variables/functions/class members (properties, methods), etc.
- lowercase_with_underscores (snakeCase): for files/directories/packages/libraries, etc.

### Import.
- Place imports starting with dart: first (use lowercase_with_underscores for the import prefix).
- Next, import third-party packages (package:).
- Finally, import relative paths and files in the project.

### Using Dart.
- Take advantage of type safety: use static typing in all code and utilise type inference wherever possible.

### UI and styling.
- Use Material widgets.
- Unify theming: use ThemeData to apply consistent styles.

### Performance optimisation.
- Prefer StatelessWidget when state is not required.
- Make use of const constructors: if widgets are immutable, use const to optimise builds.

### State management.
- Use riverpod to implement efficient state management.
- Manage state within the ViewModel and link it to the View.

### Software architecture
Use MVVM (Model View ViewModel).

### Key rules.
- To improve code readability, lines should not exceed 80 characters in length.
- Use braces {} for all flow control structures (if, for, while, etc.).
- Use comment-outs proactively to help understand and maintain code.
- Use single quotes, avoid the use of double quotes and use consistent string literals to improve readability.

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Diese Regel bündelt grundlegende Konventionen für Flutter-Projekte: sinnvolle Ordnerstruktur, Widget-Aufbau, Trennung von UI und Logik sowie Naming-Konventionen. Sie richtet sich an alle, die mit Cursor Flutter-Apps entwickeln und von Anfang an konsistenten, wartbaren Code statt improvisierter Widget-Bäume erhalten möchten. Anders als spezialisierte State-Management-Regeln deckt sie nur die Grundlagen ab, etwa Const-Konstruktoren oder die Vermeidung unnötiger Rebuilds. Besonders für Einsteiger und Teams ohne eigenen Styleguide lohnt sich der Einsatz, weil die KI dadurch von Beginn an idiomatischen statt generischen Dart-Code vorschlägt. Wer bereits eine etablierte Architektur nutzt, sollte prüfen, ob sich die Regeln überschneiden.

Praxis-Tipp

Aktivieren Sie die Regel projektweit und lassen Sie sich z. B. mit „Erstelle einen neuen Screen für die Profilseite“ ein Grundgerüst generieren, das bereits Ihrer Konvention folgt.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …