Files
cv/docs/design/specs/ui/spec-ui-projects-list.md
dong.nguyen d827bf9b23 feat: resume download, router v7/v8 migrations, spec restructure
- Add resume download button in Hero CTA and Contact section
- Migrate react-router v6→v7 and v7→v8
- Restructure specs: UI specs to specs/ui/, v2 specs to specs/v2/
- Add profile-photo assets (jpg + webp)
- Update AGENTS.md, spec-v2.md index
2026-10-06 14:14:01 +07:00

92 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# UI Spec — Projects List Page (/projects)
## Overview
Trang danh sách tất cả projects, với filter theo category.
---
## Structure
```
ProjectsListPage
├── PageHeader
│ └── Title (H1)
├── FilterBar
│ └── CategoryFilter (pills)
│ ├── All
│ ├── Software Engineering
│ ├── Logistics
│ ├── AI / ML
│ ├── Computer Vision
│ ├── Architecture
│ └── Experiment
└── ProjectGrid (×N)
└── ProjectCard (same as homepage card)
```
---
## Layout
### Desktop
- Page header: centered, H1
- Filter bar: row of pills, centered
- Grid: 2 columns
- Active filter: accent background
### Mobile
- Page header: stacked
- Filter bar: horizontal scroll pills
- Grid: 1 column
- Active filter: accent fill
---
## FilterBar
| Variant | Style |
|---|---|
| Default | Transparent bg, muted border, muted text |
| Active | Accent bg, white text |
| Hover | Accent border |
---
## Typography
| Element | Size | Weight |
|---|---|---|
| Page title (H1) | 40px / 32px mobile | 600 |
| Filter pill | 14px | 500 |
---
## Accessibility
- H1 page title
- Filter pills: `role="listbox"`, active item `aria-selected="true"`
- Keyboard navigate filters (arrow keys)
- Project cards: `<article>` semantic
---
## State
| State | Description |
|---|---|
| Default (All) | Show all projects |
| Filtered | Show only selected category |
| Empty | No projects in category → show message |
---
## Constraints
- Data-driven từ `projects.ts`
- Filter state trong URL query param (`?category=ai-ml`)
- URL state shareable
- ProjectCard reuse từ homepage component