Flutter Feature-First Architecture
A skill that guides Claude to design and build Flutter apps with layered architecture and feature-first folder organization.
Dev & CodingIntermediate★ 614⑂ 60AI score 8/10Last updated: Aug 4, 2026
What it does
- Enforces splitting a Flutter app into a UI layer, optional logic (domain) layer, and data layer, with strict adjacent-layer communication.
- Provides a canonical feature-first structure (
lib/features/<name>/data|domain|ui, pluscore/andshared/). - Defines responsibilities for View, business logic holder (ViewModel/Cubit/Controller/Notifier), Repository as single source of truth, and stateless Service.
- Shows constructor-based dependency injection and a
service_locator.dartregistration pattern, plus a 7-step workflow for adding a feature. - State-management agnostic: works with Provider, Riverpod, BLoC, or plain ChangeNotifier.
Who it's for
- Flutter developers starting a new app who want a clean structure from day one.
- Teams refactoring legacy apps where widgets call APIs directly.
- Multi-developer repos that need one shared architectural convention.
Examples
- "Add a profile-edit feature" → scaffolds
features/profile_edit/with service → repository → viewmodel → screen and registers DI. - "This screen calls the API directly, clean it up" → moves service calls into a repository and exposes state through the view model.
- "Where should this logic live?" → Claude weighs complexity and reuse to decide whether a domain-layer use case is justified.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/evanca/flutter-ai-rules/HEAD/skills/architecture-feature-first/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/architecture-feature-first folder from the GitHub repo evanca/flutter-ai-rules into my ~/.claude/skills/architecture-feature-first/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/evanca/flutter-ai-rules.git && mkdir -p ~/.claude/skills && cp -r flutter-ai-rules/skills/architecture-feature-first ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repository:
git clone https://github.com/evanca/flutter-ai-rules.git - Create the skills folder if needed:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r flutter-ai-rules/skills/architecture-feature-first ~/.claude/skills/ - Verify that
~/.claude/skills/architecture-feature-first/SKILL.mdexists. - Restart Claude Code, then ask something like "scaffold a new feature folder" inside a Flutter project to trigger the skill.
View source on GitHub ↗License: MIT