Keyboard Shortcuts

j / kScroll down / up
ggScroll to top
GScroll to bottom
/Open search
?Show this help
EscClose search / help
n / NNext / previous section
hGo to landing
dGo to docs
:Command mode — type section name

Press ? or Esc to close

Getting Started

New Feature Checklist

Every feature follows this exact shape. No exceptions, no negotiation.

Create features/{name}/ folder
Add config/ — route + DI files. This is the only public API of the feature.
Add data/models/ — DTOs with fromJson / toJson / empty()
Add data/source/ — raw API calls only, return raw Response
Add data/store/ — extending BaseStore
Add data/local/ — only if offline is a confirmed requirement
Add logic/ — Cubit + State with initial() + copyWith()
Add presentation/ — screens + widgets, stateless only
Register route in app/app_router.dart
Register DI on route entry, unregister on pop
sam's arch — A Pragmatic Flutter Architecture