cobble.

Documentation

Everything written down.

Eight guides. The first three are for using the app, the next three for changing it, and the last two for the questions that come after both.

01

Getting started

Your first moment, the sample city, where the archive actually lives, and the two ways to keep it safe.

read when: you have just opened the app
02

How the city works

The five rules behind the skyline: districts, weight, repetition, the seed that draws each block, and the atmospheres.

read when: you want to read your own skyline
03

Architecture

The five files, the render loop, the storage layer, the worker and the cache, the experimental 3D layer, and why there is no build step.

read when: you are about to change the code
04

Data model

The moment schema, the IndexedDB layout, the localStorage fallback, and the .cobble file format down to the byte.

read when: you are writing an importer or a backup tool
05

Privacy & security

What is stored, the three things that leave the device, the exact cryptography, and the honest limits of a six-digit PIN.

read when: you are deciding what to write in it
06

Customising

Palette tokens, districts, atmospheres, copy and layout — and how to change the fonts, the vendor files and what the worker caches.

read when: you want it to look like yours
07

Deploying

GitHub Pages, any static host, a LAN server, and packaging it as a desktop or Android app.

read when: it needs to live somewhere
08

FAQ

Lost data, a share file that will not open, how many moments fit, browser support, and why there is no search yet.

read when: something has gone wrong
Offline self-test Performance Enhancement list Changelog Notices Privacy Security Licence Issues