Navigating Adult Life

A funny, replayable life simulator where you grow up Nigerian: school, hustle, love, family and legacy, from age 6 to old age. Mobile-first browser game (installable PWA). Starts in Lagos. You walk around a 3D neighbourhood (joystick, WASD or tap to walk), visit places (home, school, market, buka, pitch, bus stop, workplace, job centre), talk to people, and live your year there. A simple menu mode is available for older phones.

Status: Milestone 1 (playable life simulation) is implemented. See docs/PRD.md for the full product requirements and docs/STATUS.md for what is done against the M1 acceptance criteria.

Run it

npm install
npm run dev          # http://localhost:5173
npm test             # unit, property and bot-simulation tests
npm run sim -- 200   # balance simulator: 200 bot lives per strategy
npm run build        # production build to dist/

Useful URL flags: ?unlimited=1 (disable the playtime meter for testing), ?debug=1 (exposes window.__nal.jump(age) for e2e).

End-to-end screenshots/flows use headless Chromium (CHROME=<headless_shell path> npm run e2e after npm run build && npx vite preview --port 4173).

Architecture

Path	What
src/engine	Pure TypeScript simulation. No DOM/React/Three.js. Deterministic (seeded RNG), serialisable state. Public API in src/engine/api.ts.
src/content	Data only: events, jobs, traits, quests, achievements, quiz bank, names. Add content here, not code.
src/world	The walkable 3D district: layout and pathfinding (pure, tested), Three.js renderer, characters, guidance.
src/minigames/go-slow-dash	Pure runner simulation (sim.ts) + Three.js renderer (renderer.ts). Lazy-loaded.
src/ui	React screens, modals, avatar and scene art (SVG, procedural).
src/platform	Saves, meta profile, playtime tokens, audio (synthesised placeholders), share card, feedback.
docs/adr	Architecture decisions.

Placeholders: music and art are procedural/synthesised. To replace them, add files to src/assets/manifest.ts (no code changes needed).

Adding an event

Add an ev({...}) entry in src/content/events/*.ts using the helpers in dsl.ts. Tests check ids, choices, string lengths and soft-locks. Mark culturally uncertain content for owner review and use the in-game 🚩 button during playtests.