hackathon/CLAUDE.md

Project

Webcam pose detection app using MediaPipe Tasks Vision. Vite + React 19 + TypeScript.

Commands

• npm run dev - start dev server
• npm run build - typecheck then build (tsc -b && vite build)
• npm run lint - eslint
• npm run preview - preview production build

Workflow

• Commit on your own after completing a reasonable chunk of work. Don't wait to be asked.

Deploy

1. npm run build — typecheck + vite build
2. npx vercel build --prod — prepare Vercel output in .vercel/output
3. Copy output outside git repo and deploy from there (avoids commit author verification):

   rm -rf /tmp/vercel-deploy && mkdir -p /tmp/vercel-deploy/.vercel
   cp .vercel/project.json /tmp/vercel-deploy/.vercel/
   cp -r .vercel/output /tmp/vercel-deploy/.vercel/output
   cd /tmp/vercel-deploy && npx vercel deploy --prebuilt --prod
   

• Site: https://hackhackrevolution.xyz
• Vercel project: project-zcx72 under jorqsrazes-projects

Song Sources

• Fraxtil's Beast Beats [SM5] — 20 songs bundled with the game
• Just Dance (Lady Gaga) — simfile from https://zenius-i-vanisher.com/v5.2/viewsimfile.php?simfileid=35263

Code guidelines

• Modular architecture: each file should have a single, clear responsibility. Extract logic into separate modules rather than growing large files.
• Good abstractions: group related logic into custom hooks, utility modules, or components. Keep rendering, state management, and business logic in separate layers.
• Easy to maintain: prefer small, focused functions and components. Name things clearly so intent is obvious without comments.
• Keep types in dedicated files (e.g. types.ts), not scattered across components.
• Use type imports for type-only imports (import type { ... }).
• No default exports for non-page components; use named exports.