Files
cv/docs/design/specs/v2/spec-v2-router-v8.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

2.7 KiB

Specification — v2 React Router v7 → v8 Migration

Document: spec-v2-router-v8.md Version: 0.1.0 Parent: spec-v2.md Priority: P0 (prerequisite for v2) Estimate: ~15 minutes


Background

React Router v8 consolidates DOM APIs into react-router/dom and removes the react-router-dom re-export package. This app uses only the declarative mode (<BrowserRouter> + <Routes> + <Route>) — no data router, no loaders, no actions, no meta functions, no splat routes.

Current state:

  • react-router pinned at 7.18.4
  • 4 files import from react-router
  • No react-router-dom (already removed in v7 migration)
  • No meta functions, no useMatches().data, no data router APIs
  • React ^19.2.8 (≥ 19.2.7 ✅)
  • Vite ^8.3.0 (≥ 7 ✅)

Analysis

Future flags

All 5 future flags are framework/data mode only. Not applicable to this app:

Flag Applicable? Notes
v8_middleware No No data router / framework mode
v8_splitRouteModules No No <RouterProvider> / data router
v8_viteEnvironmentApi No No SSR / custom server config
v8_passThroughRequests No No loaders/actions
v8_trailingSlashAwareDataRequests No No .data request handling

Breaking changes

Change Applicable? Notes
meta/matches .data → loaderData No No meta functions
react-router-dom removal No Already removed in v7 migration
Cloudflare plugin No Not using Cloudflare
@react-router/architect No Not using adapters

Minimum versions

Requirement Current Required Status
react ^19.2.8 ≥19.2.7 ✅
react-dom ^19.2.8 ≥19.2.7 ✅
vite ^8.3.0 ≥7 ✅

Implementation Steps

Step 1: Update package.json

- "react-router": "7.18.4"
+ "react-router": "8.4.0"

Step 2: Install and verify

pnpm install
pnpm build
pnpm lint

Acceptance

  • package.json has react-router@8.4.0
  • pnpm build succeeds without errors
  • Dev server runs without console warnings
  • All routes work correctly (/ → /about → /projects → /projects/:id → /engineering → /contact)
  • Navigation highlighting works (NavLink active state)
  • Mobile menu still works
  • Project detail page works (useParams + Link)

Notes

  • v8 upgrade is non-breaking for this app (pure declarative <BrowserRouter> pattern)
  • No code changes needed — only package version bump
  • react-router-dom already removed in v7 migration
  • All future flags are framework/data mode only, not applicable to this app