Skillshub flutter-layer-based-clean-architecture

Layer separation and DDD standards. ALWAYS consult when working in lib/domain/, lib/infrastructure/, lib/application/, or lib/presentation/ — for entities, repositories, mappers, BLoCs, or screens. (triggers: lib/domain/**, lib/infrastructure/**, lib/application/**, dto, mapper, Either, Failure)

install

source · Clone the upstream repo

git clone https://github.com/ComeOnOliver/skillshub

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/HoangNguyen0403/agent-skills-standard/flutter-layer-based-clean-architecture" ~/.claude/skills/comeonoliver-skillshub-flutter-layer-based-clean-architecture && rm -rf "$T"

manifest: skills/HoangNguyen0403/agent-skills-standard/flutter-layer-based-clean-architecture/SKILL.md

source content

Layer-Based Clean Architecture

Priority: P0 (CRITICAL)

Standardized separation of concerns and dependency flow using DDD principles.

Structure

lib/
├── domain/ # Pure Dart: entities (@freezed), failures, repository interfaces
├── infrastructure/ # Implementation: DTOs, data sources, mappers, repo impls
├── application/ # Orchestration: BLoCs / Cubits
└── presentation/ # UI: Screens, reusable components

Implementation Guidelines

Dependency Flow:

Presentation -> Application -> Domain <- Infrastructure

. Dependencies point inward.

Pure Domain: No Flutter (Material/Store) or Infrastructure (Dio/Hive) dependencies in
```
Domain
```
.
Functional Error Handling: Repositories must return
```
Either<Failure, Success>
```
.
Always Map: Infrastructure must map DTOs to Domain Entities; do not leak DTOs to UI.
Immutability: Use
```
@freezed
```
for all entities and failures.
Logic Placement: No business logic in UI; widgets only display state and emit events.
Inversion of Control: Use
```
get_it
```
to inject repository implementations into BLoCs.

Anti-Patterns

No DTOs in UI: Never import a
```
.g.dart
```
or Data class directly in a Widget.
No Material in Domain: Do not import
```
package:flutter/material.dart
```
in the
```
domain
```
layer.
No Shared Prefs in Repo: Do not use
```
shared_preferences
```
directly in a Repository; use a Data Source.

Reference & Examples

For full implementation templates and DTO-to-Domain mapping examples: See references/REFERENCE.md.