This repository contains the production source for a cinematic, single-page portfolio built to present systems architecture work through interactive motion, 3D visuals, and curated project data.
- Next.js 14 (App Router, static export)
- TypeScript
- Tailwind CSS
- GSAP (ScrollTrigger)
- Three.js + React Three Fiber
- SWR
Project data uses a hybrid GitHub pipeline:
- Build-time snapshot at
public/data/github-snapshot.json - Runtime refresh from GitHub API
- Automatic fallback to the snapshot when live fetch fails
npm install
npm run devnpm run snapshot # refresh GitHub snapshot data
npm run lint # eslint (Next.js config)
npm run typecheck # tsc --noEmit
npm run build # static export (writes to out/)npm run build executes prebuild, which refreshes the snapshot automatically.
GitHub Actions workflow: .github/workflows/nextjs.yml
- Runs on
pull_requestandpushtomain - Enforces
lintandtypecheckbefore build - Builds static output and deploys to GitHub Pages on non-PR runs