mirror of
https://github.com/dong-nz/cv.git
synced 2026-11-23 00:20:40 +07:00
- 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
157 lines
2.8 KiB
Markdown
157 lines
2.8 KiB
Markdown
# UI Spec — Projects Section
|
||
|
||
## Overview
|
||
|
||
Homepage section hiển thị 3–4 featured projects dạng grid cards.
|
||
|
||
---
|
||
|
||
## Structure
|
||
|
||
```
|
||
ProjectsSection
|
||
├── SectionHeading ("Featured Projects")
|
||
├── ProjectGrid (×3–4)
|
||
│ └── ProjectCard (×N)
|
||
│ ├── CategoryBadge
|
||
│ ├── Title
|
||
│ ├── Summary (1–2 lines)
|
||
│ ├── TechStack (tags)
|
||
│ ├── Metrics (optional)
|
||
│ └── CTA ("View Details")
|
||
└── ViewAllLink → /projects
|
||
```
|
||
|
||
---
|
||
|
||
## Content Model
|
||
|
||
```ts
|
||
interface Project {
|
||
id: string;
|
||
title: string;
|
||
summary: string;
|
||
category: ProjectCategory;
|
||
role: string;
|
||
technologies: string[];
|
||
metrics?: string[];
|
||
featured: boolean;
|
||
githubUrl?: string;
|
||
demoUrl?: string;
|
||
images?: string[];
|
||
}
|
||
|
||
type ProjectCategory =
|
||
| "software-engineering"
|
||
| "logistics"
|
||
| "ai-ml"
|
||
| "computer-vision"
|
||
| "architecture"
|
||
| "experiment";
|
||
```
|
||
|
||
---
|
||
|
||
## Layout
|
||
|
||
### Desktop
|
||
|
||
- Grid: 2 columns (2x2)
|
||
- Cards: equal height, flex layout
|
||
- Category badge: top-left corner
|
||
- Title: H3, accent color
|
||
- Summary: 2 lines max, truncate
|
||
- Tech stack: row of small pills
|
||
- Metrics: accent highlight box
|
||
- CTA: link/button dưới cùng
|
||
|
||
### Mobile
|
||
|
||
- Single column stack
|
||
- Cards full-width
|
||
- Summary: 1 line max
|
||
- Tech stack: wrap pills
|
||
- CTA: full-width button
|
||
|
||
### Tablet
|
||
|
||
- Grid: 1 column (or 2 if cards small)
|
||
|
||
---
|
||
|
||
## ProjectCard
|
||
|
||
| Variant | Style |
|
||
|---|---|
|
||
| Default | Border, padding, flex column |
|
||
| Hover | Shadow, border accent, lift 2px |
|
||
| Featured | Accent top border (4px) |
|
||
|
||
---
|
||
|
||
## CategoryBadge
|
||
|
||
| Category | Color |
|
||
|---|---|
|
||
| software-engineering | accent color |
|
||
| logistics | accent color |
|
||
| ai-ml | accent color |
|
||
| computer-vision | accent color |
|
||
| architecture | accent color |
|
||
| experiment | accent color |
|
||
|
||
_Only one accent color — use different icon/symbol per category if needed._
|
||
|
||
---
|
||
|
||
## Typography
|
||
|
||
| Element | Size | Weight |
|
||
|---|---|---|
|
||
| Section heading (H2) | 40px / 32px mobile | 600 |
|
||
| Card title (H3) | 20px | 600 |
|
||
| Summary | 14px | 400 |
|
||
| Tech tag | 12px | 400 |
|
||
| Metric | 14px | 600 |
|
||
| CTA | 14px | 500 |
|
||
|
||
---
|
||
|
||
## Accessibility
|
||
|
||
- H2 section, H3 card titles
|
||
- Cards: `<article>` semantic
|
||
- Links: `aria-label` với project name
|
||
- Category badge: `aria-label` với category
|
||
- Focus visible trên CTA
|
||
- Contrast >= 4.5:1
|
||
|
||
---
|
||
|
||
## Animation
|
||
|
||
- Cards fade-in stagger (100ms delay)
|
||
- Hover: lift + shadow transition 200ms
|
||
- CTA: color transition 150ms
|
||
|
||
---
|
||
|
||
## State
|
||
|
||
| State | Description |
|
||
|---|---|
|
||
| Default | Normal render |
|
||
| Hover | Lift, shadow, border accent |
|
||
| Focus | Visible outline |
|
||
| Scroll reveal | Fade-in + slide-up |
|
||
| Reduced motion | Disable animations |
|
||
|
||
---
|
||
|
||
## Constraints
|
||
|
||
- Data-driven từ `projects.ts`
|
||
- Chỉ render featured projects trên homepage
|
||
- Filterable by category (future phase)
|
||
- CTA navigate to `/projects/:projectId`
|