swe-programming-dartlisted

# Dart Coding Standards ## Purpose Progressive disclosure of Dart coding standards for agents writing Dart code. **Authoritative Source**: [docs/explanation/software-engineering/programming-languages/dart/README.md](../../../docs/explanation/software-engineering/programming-languages/dart/README.md) **Usage**: Auto-loaded for agents when writing Dart code. Provides quick reference to idioms, best practices, and antipatterns. ## Prerequisite Knowledge **IMPORTANT**: This skill provides **demo-specific style guides**, not educational tutorials. **You MUST understand Dart fundamentals before using these standards.** Complete the demo Dart learning path first: **What this skill covers**: demo naming conventions, framework choices, repository-specific patterns. **What this skill does NOT cover**: Dart syntax, language fundamentals, generic patterns (those are in crud-fs-ts-nextjs). ## Quick Standards Reference ### Naming Conventions **Files and Packages**: lowercase_with_underscores - `zakat_calculator.dart`, `murabaha_service.dart` - Package names: `zakat_app`, `islamic_finance` **Classes and Types**: UpperCamelCase - `ZakatCalculator`, `MurabahaContract`, `PaymentStatus` **Functions, Variables, Parameters**: lowerCamelCase - `calculateZakat()`, `totalAmount`, `paymentDate` **Constants**: lowerCamelCase (not UPPER_CASE in Dart) - `const defaultNisab = 5000.0;` - `static const zakatRate = 0.025;` ### Null Safety (Dart 3.0+) **Non-nullable by default**: ```dar