How sandromaglione/inkline-town works
Inkline Town is a browser-based, term-by-term town-building simulation. The player creates a charter, lays out and manages a town, and receives a term verdict and chronicle. The browser app composes the DOM UI, simulation, and 3D renderer; scheduled systems advance the town, while edits from the player are applied during simulation steps. The README documents production, logistics, services, hazards, upgrades, trade, and rank progression. Some subsystem links are based on documented capabilities rather than sampled implementation; those are cited to the README.
Main entry points: browser.ts Browser App · schedule.ts Step Scheduler · index.ts DOM UI · scene.ts 3D Scene
Components 22
Player Experience
- Browser App
src/app/browser.ts - DOM UI
src/ui/dom/index.ts - Term Verdict
Town Simulation
- Player Edits
src/game/edits.ts - Step Scheduler
src/game/schedule.ts - Term and Goals
src/game/systems/term - Production
src/game/systems/work - Goods Logistics
src/game/systems/logistics - Households and Town
src/game/systems/town - Risks and Decay
src/game/systems/hazards - Walkers and Services
src/game/systems/walkers
World and Content
- Game Content
src/game/content/kinds/kind.ts - Town State
src/game/schema.ts - Land and Grid
src/game/world/grid.ts
View and Rendering
- View Contracts
src/view/contracts.ts - View Systems
src/view/preview.ts - 3D Scene
src/render/pixi3d/scene.ts - Ink Artwork
src/render/art.ts
Persistence and Sharing
- Local Saves
src/platform/save.ts - Share Client
src/platform/share/client.ts - Share Format
src/platform/share/format.ts
Other components
- Mayor
Connections 29
- Mayor → Browser App: plays in
README.md - Browser App → DOM UI: composes
src/app/browser.ts - Browser App → Step Scheduler: runs
src/app/browser.ts - Browser App → 3D Scene: connects renderer
src/app/browser.ts - Browser App → Local Saves: uses persistence
src/app/browser.ts - Browser App → Share Client: uses sharing
src/app/browser.ts - DOM UI → Player Edits: sends edits
src/ui/dom/index.ts - DOM UI → View Contracts: reads view state
src/ui/dom/index.ts - Step Scheduler → Term and Goals: dispatches
src/game/schedule.ts - Step Scheduler → Production: dispatches
src/game/schedule.ts - Step Scheduler → Goods Logistics: dispatches
src/game/schedule.ts - Step Scheduler → Households and Town: dispatches
src/game/schedule.ts - Step Scheduler → Risks and Decay: dispatches
src/game/schedule.ts - Step Scheduler → Walkers and Services: dispatches
src/game/schedule.ts - Player Edits → Town State: changes state
src/game/edits.ts - Game Content → Town State: defines components for
src/game/schema.ts - Land and Grid → Town State: provides grid functions
src/game/world/grid.ts - Browser App → Game Content: loads content
src/app/browser.ts - Browser App → Player Edits: loads edit logic
src/app/browser.ts - View Systems → View Contracts: produces view data
src/view/contracts.ts - 3D Scene → View Contracts: renders scene view
src/render/pixi3d/scene.ts - 3D Scene → Ink Artwork: uses artwork
src/render/pixi3d/scene.ts - Local Saves → Browser App: restores town
src/app/browser.ts - Share Client → Share Format: formats share data
src/platform/share/client.ts - Term and Goals → Term Verdict: judges term
README.md - Production → Goods Logistics: makes goods for
README.md - Walkers and Services → Households and Town: serves households
README.md - Risks and Decay → Term Verdict: can end term
README.md - DOM UI → Mayor: shows controls
src/ui/dom/index.ts