Fsd Scaffold

FSD Scaffold

When asked to write code for a feature or entity, check if the slice exists first — scaffold any missing structure before implementing.

Slice Structure

src/[entities|features]/<slice-name>/
├── api/
│   ├── service.ts
│   ├── query.ts
│   └── actions.ts  (features only)
├── model/
│   └── dto.ts
├── ui/
│   ├── ComponentName.tsx
│   └── index.ts    ← barrel file, re-exports all ui components
├── types/
├── constants/
└── index.ts        ← barrel file, re-exports the slice's public API

Layer Rules

• entities/ — read-only domain data (fetching only, no mutations)
• features/ — user interactions that mutate data (requires actions.ts)

Process

1. Check existing structure

Use find or ls to check whether src/entities/<name>/ or src/features/<name>/ already exists.

2. Determine the layer

• GET only → entities/
• PATCH / POST / PUT / DELETE → features/

3. Scaffold missing directories and files

Create only what is needed for the current task. Always create index.ts to export the slice's public API.

4. Read conventions before writing each file type

Before creating any file, read the relevant convention file:

5. Implement the requested code

Follow the loaded conventions exactly.