mirror of
https://github.com/dong-nz/cv.git
synced 2026-11-22 16:10:40 +07:00
137 lines
2.6 KiB
Markdown
137 lines
2.6 KiB
Markdown
# UI Spec — Layout & Theme
|
||
|
||
## Overview
|
||
|
||
Global layout structure, theme system, and page transitions.
|
||
|
||
---
|
||
|
||
## Layout Structure
|
||
|
||
```
|
||
App
|
||
├── Navigation (sticky top)
|
||
├── Main Content
|
||
│ └── Page Container
|
||
│ └── Page Content
|
||
└── Footer (bottom)
|
||
```
|
||
|
||
---
|
||
|
||
## Page Container
|
||
|
||
| Property | Value |
|
||
|---|---|
|
||
| Max-width | 1200px (wide sections), 800px (content sections) |
|
||
| Padding | 0 24px (desktop), 0 16px (mobile) |
|
||
| Margin | Auto center |
|
||
|
||
---
|
||
|
||
## Section Spacing
|
||
|
||
| Property | Value |
|
||
|---|---|
|
||
| Vertical padding | 80px (desktop), 48px (mobile) |
|
||
| Between sections | 0 (continuous flow) |
|
||
|
||
---
|
||
|
||
## Theme System
|
||
|
||
### Modes
|
||
|
||
| Mode | Description |
|
||
|---|---|
|
||
| Dark | Primary mode, near-black background |
|
||
| Light | Secondary mode, white background |
|
||
| System | Follow OS preference |
|
||
|
||
### Default
|
||
|
||
- System preference
|
||
- Persist in `localStorage`
|
||
|
||
### CSS Variables
|
||
|
||
```css
|
||
/* Dark mode (default) */
|
||
--bg-primary: #0a0a0a;
|
||
--bg-surface: #141414;
|
||
--bg-elevated: #1a1a1a;
|
||
--text-primary: #f0f0f0;
|
||
--text-secondary: #a0a0a0;
|
||
--text-muted: #666666;
|
||
--accent: #60a5fa;
|
||
--border: #2a2a2a;
|
||
--shadow: rgba(0, 0, 0, 0.3);
|
||
|
||
/* Light mode */
|
||
--bg-primary: #ffffff;
|
||
--bg-surface: #f5f5f5;
|
||
--bg-elevated: #ffffff;
|
||
--text-primary: #0a0a0a;
|
||
--text-secondary: #404040;
|
||
--text-muted: #808080;
|
||
--accent: #2563eb;
|
||
--border: #e0e0e0;
|
||
--shadow: rgba(0, 0, 0, 0.1);
|
||
```
|
||
|
||
### Single Accent Color
|
||
|
||
- Only one accent color per theme
|
||
- Avoid multi-color palette
|
||
- Use accent for: links, active states, CTAs, badges, highlights
|
||
|
||
---
|
||
|
||
## Theme Toggle
|
||
|
||
| Property | Value |
|
||
|---|---|
|
||
| Location | Navigation bar (right side) |
|
||
| Icon | Sun/Moon icon |
|
||
| Tooltip | Current mode (dark/light/system) |
|
||
| Click behavior | Cycle: dark → light → system → dark |
|
||
|
||
---
|
||
|
||
## Page Transitions
|
||
|
||
- Fade transition between routes (200ms)
|
||
- No slide, no parallax
|
||
- Respect `prefers-reduced-motion`
|
||
|
||
---
|
||
|
||
## Responsive Breakpoints
|
||
|
||
| Breakpoint | Width | Description |
|
||
|---|---|---|
|
||
| Mobile | < 768px | Single column, touch-optimized |
|
||
| Tablet | 768–1023px | Adaptive grid |
|
||
| Desktop | >= 1024px | Multi-column, wide layouts |
|
||
|
||
---
|
||
|
||
## Accessibility
|
||
|
||
- `prefers-color-scheme` media query
|
||
- `prefers-reduced-motion` media query
|
||
- Theme toggle: `aria-label` with current mode
|
||
- Focus visible: accent color outline (2px)
|
||
- Contrast ratio >= 4.5:1 for all text
|
||
- No theme flash on page load (inline script)
|
||
|
||
---
|
||
|
||
## Constraints
|
||
|
||
- Theme state in context/provider (not global store)
|
||
- Persist preference in `localStorage`
|
||
- Inline script in `<head>` to prevent flash
|
||
- CSS variables for all theme values
|
||
- No hardcoded colors in components
|