A guided portfolio project for learning product design and building a polished React + TypeScript application.
npm install
npm run devBefore coding, read docs/PRODUCT_BRIEF.md.
- Vite, React, and strict TypeScript
- ESLint
- Vitest and Testing Library
- Responsive application shell
- CSS design tokens for colour, spacing, type, radius, and elevation
- An accessible empty state and first interaction test
- A narrow product brief that protects the MVP from scope creep
Work through one milestone at a time. Each milestone should finish with working UI, tests, and a short written reflection.
Build a form inside the existing panel. Do not add a backend yet.
Fields:
- Name (required)
- Category: top, bottom, dress, outerwear, shoes, accessory
- Primary colour
- Season: all-season, spring/summer, autumn/winter
Your first tasks:
- Create
src/types/garment.tsand define theGarmenttype. - Create
src/components/GarmentForm.tsx. - Use real
<label>elements and show a clear validation message for an empty name. - Store submitted garments in
Appstate. - Replace the empty state with a simple list after the first garment is added.
- Add tests for invalid and successful submission.
Definition of done:
- The flow works using only the keyboard.
- Invalid input explains how to fix it.
- Submitting updates the screen immediately.
- Tests cover the user behaviour rather than implementation details.
npm run lint,npm test, andnpm run buildall pass.
Design the garment card in Figma first. Implement category, colour, and season filters. Make filter state visible and provide a useful zero-results state.
Move garments from local state to an API and database. Add loading, error, retry, and optimistic states.
Let users select compatible garments, preview a combination, name it, and save it. Ensure selection works without drag-and-drop.
Add accounts, protected data, authorization checks, and a public read-only outfit link.
Document the problem, early sketches, user feedback, design system, technical decisions, accessibility, tests, trade-offs, and what changed after observation.
For each milestone:
- You make the first small attempt.
- Share the result or ask for the next task.
- We review the design and code together.
- You revise it and record what you learned.
The immediate next step is Milestone 1, task 1: define the garment data model before building its form.