s_project_web — 3D Profile Page (web)

Mobile-column profile page with a 3D room panel, preset camera angles, and free-orbit exploration. Built on three.js + Vite + TypeScript.

Stack

• three.js + Vite + TypeScript (strict mode)
• GLTFLoader for avatars (FBX fallback via dynamic import)
• Web Audio API scaffolding (master → music/sfx/spatial/voice buses)

Dev loop

npm install
npm run dev          # Vite on http://localhost:5173
npm run typecheck
npm run build && npm run preview

Assets

Drop files under public/ — they ship as-is into the build root:

• public/avatars/MC.glb — the default avatar loaded at boot

Note: Git LFS is not used. GitHub Pages cannot serve LFS objects (clients get the pointer file instead of the binary), so shipped assets are committed directly. Keep public/ lean.

Deploying to GitHub Pages

1. Create the GitHub repo and push (see below).
2. In the repo settings → Pages → Build and deployment, set Source to GitHub Actions.
3. Push to main. The workflow in .github/workflows/deploy.yml builds and publishes dist/ to Pages. The site URL appears in the Actions run summary.

The Vite config uses base: './', so the build works at any subpath (project pages, user pages, custom domain) with no rebuild per host.

First-time push

git init
git add .
git commit -m "Initial commit: 3D profile page scaffold"
git branch -M main
git remote add origin https://github.com/<you>/<repo>.git
git push -u origin main