A Matrix-themed interactive portfolio website featuring a breakout-style game, built with React, TypeScript, and Anime.js.
- 🎮 Interactive Game: Breakout-style game on the home page with a custom physics engine, collision detection, lives, pause menu, and Web Audio sound effects
- 🏆 Scoring: Points with floating score popups, a play timer that pauses with the game, a best score saved in
localStorage, and a global top-10 leaderboard (a Worker at/api/scoresbacked by a SQLite Durable Object) - 🎨 Matrix Theme: Retro green-on-black aesthetic with Matrix rain, HUD frame, CRT backdrop (glow, scanlines, scan beam, vignette), and decrypting text effects
- 🔀 Page Transitions: Route changes animate with the View Transitions API
- 👤 About Page: Terminal-style hero, experience log, and GitHub stats (counters and language breakdown)
- 🗂️ Projects Page: Project cards driven by a simple data file
- ⚡ Smooth Animations: Powered by Anime.js, with support for
prefers-reduced-motion - 📱 Responsive & Touch-Friendly: Tailwind CSS layout with touch controls for the game
- 🔎 SEO: Per-route meta tags, structured data,
sitemap.xml, androbots.txtgenerated at build time - ☁️ Cloudflare Ready: Built and deployed with the Cloudflare Vite plugin and Wrangler
- Framework: React 19 with TypeScript
- Build Tool: Vite 8
- Styling: Tailwind CSS 4
- Animations: Anime.js 4
- Routing: React Router 7
- Deployment: Cloudflare (via Wrangler)
- Icons: Radix UI Icons
- Node.js (v20 or higher recommended)
- npm
npm installnpm run devVisit http://localhost:5173 to view the application. The dev server is exposed on your network and prints a QR code so you can open it on a phone.
| Command | Description |
|---|---|
npm run dev |
Start the Vite dev server |
npm run build |
Type-check and build for production |
npm run lint |
Run ESLint |
npm run preview |
Build, then serve the production build with Wrangler |
npm run deploy |
Build, then deploy to Cloudflare |
The About page reads a snapshot from src/pages/About/github-stats.json. To refresh it:
node scripts/github-stats.mjs
# Also sum lines added across repos (slow; set a token to avoid the 60 req/hr limit)
GITHUB_TOKEN=<token> node scripts/github-stats.mjs --lines.github/workflows/ci.yml runs lint, build (with typecheck) and tests on every pull request and push to main.
Deploying to Cloudflare on main is opt-in. To enable it, in the repo's GitHub settings:
- Add the secrets
CLOUDFLARE_API_TOKEN(with the "Edit Cloudflare Workers" template) andCLOUDFLARE_ACCOUNT_ID. - Add the repository variable
DEPLOY_ENABLED=true.
SESSION_SECRET is a Worker secret, not a CI secret. Set it once with npx wrangler secret put SESSION_SECRET.
src/
├── components/
│ ├── common/ # Shared app pieces (navigation, game overlay, HUD, backdrop, Matrix rain, splash)
│ ├── layout/ # Page layout
│ └── ui/ # Small UI primitives (Button, Kbd, DecryptText, RotatingText, ...)
├── context/ # Game state (score, best score, lives, timer, sound)
├── hooks/ # Shared hooks (page meta, reveal, rotating text, sound)
├── pages/ # Home (game), About, Projects, NotFound
├── routes/ # Router configuration and route paths
├── lib/ # Utility functions
└── seo.ts # Site and per-page SEO metadata
scripts/ # Maintenance scripts (GitHub stats snapshot)
seo-plugin.ts # Vite plugin that injects SEO tags and emits sitemap/robots
| Action | Keyboard | Touch |
|---|---|---|
| Launch the ball | Space or drag it |
Tap or flick the ball |
| Move the paddle | ← / → |
Drag anywhere |
| Pause / resume | Space or Esc |
Pause button in the HUD |
Objective: Break every character in the welcome text before you run out of lives (you start with 3).
Scoring:
| Event | Points |
|---|---|
| Ball hits a character | +10 |
| Catch a falling character on the paddle | +5 |
Your best score is kept between visits.
HUD & Menus:
- While playing, the HUD shows your lives, score, and a play timer, plus buttons to mute sound and pause
- The timer only runs while the ball is in play, so pausing stops the clock
- The pause menu lets you resume, restart, or jump to the Projects page
- Winning or losing shows your score, lives, and best score (flagged when you set a new best), with options to play again or explore my work
MIT