flutter-init_skill

Overview

This skill scaffolds a new Flutter app with a domain-focused Clean Architecture using Riverpod 3.0, Drift, Freezed and a modern Flutter stack. It interactively collects domain, project and stack choices, then generates a ready-to-run CRUD project (Todo/Habit/Note/Expense or custom). The generator runs codegen, applies compatibility fixes, and validates with flutter analyze until errors are resolved.

How this skill works

You choose a domain and a preset (Minimal/Essential/Full/Custom) and provide folder, package and org names. The skill runs flutter create, updates pubspec and project structure, generates domain/data/presentation boilerplate (entities, Drift tables, repositories, Riverpod providers, screens), runs build_runner and performs automated code checks and fixes. Final validation requires flutter analyze with errors resolved before completion.

When to use it

• You want a production-ready CRUD app scaffolded quickly (Todo/Habit/Note/Expense).
• You need a Clean Architecture starter with Riverpod 3.x, Drift, and Freezed set up correctly.
• You want consistent project conventions: package imports, codegen, and analyzer-clean code.
• You plan to customize stack choices (navigation, error handling, fonts, auth) during project setup.
• You need a repeatable template for prototyping domain-specific apps.

Best practices

• Provide clear folder/package/org names to avoid post-creation renames.
• Choose Essential or Full Stack for most apps; Minimal is for tiny prototypes.
• Review and approve codegen and analyzer fixes; Freezed and Riverpod 3.0 changes are applied but review is required.
• Use Custom domain only when you can specify field types precisely (String,int,double,bool,DateTime).
• Run flutter analyze and address all error-level issues until 0 errors (info-only allowed) before shipping.

Example use cases

• Create a Habit tracker app with streak tracking, goal progress and habit stats prewired.
• Scaffold a Notes app with tags, search and pin features using Drift-backed persistence.
• Generate an Expense tracker with monthly/category aggregation and starter charts/providers.
• Build a Todo app with filters (all/pending/completed) and completedAt tracking for analytics.
• Define a Custom domain (e.g., Book: title:String,author:String,read:bool) and get full CRUD boilerplate.