Repository navigation
How It Works
stitchcode-bot edited this page Aug 18, 2026
·
1 revision
The full, illustrated guide lives in the repository at
docs/HOW_IT_WORKS.md.
Here is the postcard version.
YOU THE STUDIO THE PROOF
─── ────────── ─────────
type a link ──▶ letters → 0s & 1s ──▶ squares appear
pick colours ──▶ squares get dressed ──▶ proof re-colours
drop a picture ──▶ picture → tiny map ──▶ picture weaves in
press save ──▶ scanner reads it back ──▶ "✓ It works!"
sequenceDiagram
participant You
participant Studio
participant Scanner
You->>Studio: a picture
Note over Studio: 1 · fit it (never crop)
Note over Studio: 2 · tune light, pop & fade
Note over Studio: 3 · dither it 3× fine
Note over Studio: 4 · repaint ALL dots on top
Studio->>Scanner: the finished code
Scanner-->>You: ✓ scans perfectly
The code's special squares (three corners, the ruler lines, the straighten dot) are like the bones of a body — the picture may colour the skin, but the bones are never touched. That is why stitched codes still scan.
┌─────┐ · · · · · · ┌─────┐
│bone │ · timing · │bone │
└─────┘ · · · · · · └─────┘
· · · · ┌─────────┐ · · · ·
· ruler │ PICTURE │ · ◉ dot
· · · · └─────────┘ · · · ·
┌─────┐ · · · · · · ┌─────┐
│bone │ · version · │name │
└─────┘ · · · · · · └─────┘
| Topic | Where |
|---|---|
| Every box in the pipeline | docs/HOW_IT_WORKS.md |
| The six scanning rules | docs/SCAN_SAFETY.md |
| Colours & themes | docs/THEMING.md |
| Hosting it yourself | docs/SELF_HOSTING.md |
Made with care for curious people of every age · MIT licence · If it scans, ship it ✓