Feature-Driven Development (FDD) Architecture

Organize code by what it does, not what it is. Each feature is a self-contained vertical slice owning all its layers.

Mandatory Folder Structure

src/
├── features/
│   ├── <feature-name>/
│   │   ├── components/   # UI components for this feature
│   │   ├── hooks/        # Data fetching, state, side-effects
│   │   ├── services/     # API calls, business logic
│   │   ├── types/        # TypeScript interfaces/types
│   │   └── index.ts      # Public API (REQUIRED)
│   └── shared/           # Cross-feature business logic
└── components/ui/        # Universal UI primitives (Button, Input)