Files
cv/spec-ui-projects.md
T
2026-10-06 09:58:00 +07:00

2.8 KiB
Raw Blame History

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

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