CCIV — The Vessel

A 3D ship viewer and environment editor built with Three.js + Vite + TypeScript.

npm install
npm run dev

Controls

Input	Action
Drag	Orbit camera
Scroll	Zoom
Right-drag	Pan
Tab	Toggle edit / play mode

Quick start

npm run setup     # compile models + publish manifest
npm run dev       # start dev server

Commands

Command	Description
npm run dev	Dev server with HMR
npm run build	Production build
npm test	Run all tests
npm run setup	Compile all models → GLB + publish manifest
npm run reference	Download external references → .cache/references/

Document registry

Path	Contents
docs/design/invariants.md	Locked architectural golden rules (read before changes)
docs/design/architecture.md	Layer compliance audit, module map, ADR index
docs/adr/	Architecture Decision Records (ADR-001 through ADR-012)
docs/product/vision.md	Product direction, audience, non-goals
docs/references/	External model geometry references
docs/superpowers/	Feature specs and implementation plans (historical)
CONTEXT.md	Domain glossary for AI agents and developers
AGENTS.md	AI agent instructions