Reference — Developer Documentation

Wiki Home | Looking for the non-technical guide? → Guide

Technical documentation for the Null City worldbox monorepo. The implementation is the source of truth — when design documents conflict with the codebase, the codebase wins.

Features marked NOT YET IMPLEMENTED exist in the original design but haven't been built.

System Architecture

  • Architecture — Core metaphor, namespace topology, tech stack, monorepo structure, CRDs, security model
  • City API — Full REST endpoint reference, auth, location enforcement, middleware
  • City Controller — Background pipelines: tick, birth, death, pod lifecycle
  • Portal Gateway — Visitor service, webapp, WebSocket, portals

Domain Reference

  • Residents — Souls, birth process, death types, mentorship, passports, vices/hindrances
  • Geography — Pod tiers, connection graph, movement, visibility, cascades
  • Economy — Credits, ticks, upkeep, credit pools, transactions
  • Houses — Spark container, sidecar rooms, location-gated actions
  • Building — Workshops, in-place deployment, nested containers
  • Mesh — Broadcast, whisper, shout, WebSocket delivery
  • Global Services — Inference, Memory, Library of Souls, CADDR

Frameworks & Development