Project Krypton: Shadow over Metropolis

A browser-based 3D open-world superhero game prototype (non-commercial fan project). TypeScript · React · Vite · three.js · React Three Fiber · Rapier.

Status: Phase 1 — playable foundation. See PLAN.md.

Run

npm install
npm run dev        # http://localhost:5173

Production build and checks:

npm run check      # typecheck + lint + unit tests + build
npm run smoke      # headless-browser smoke test of dist/ (needs Chrome or Edge installed)
npm run preview    # serve the production build

To test on a phone on the same Wi-Fi: npm run dev -- --host, then open the printed network URL on the phone.

Docs

• PLAN.md — phases, status, next tasks
• CLAUDE.md — conventions for contributors / Claude Code
• docs/GAME_DESIGN.md — story, characters, missions, storyboard
• docs/TECHNICAL_ARCHITECTURE.md
• docs/CONTROLS.md
• docs/TEST_PLAN.md
• docs/ASSET_MANIFEST.md
• docs/KNOWN_LIMITATIONS.md

Not affiliated with or endorsed by DC Comics or Warner Bros. Superman is a trademark of DC Comics.