Surface guides

One system, six surfaces

The same tokens end up on paper, projectors, kiosks, handhelds, phones, and the web. Each surface changes the physics: viewing distance, touch target size, colour gamut, contrast. These guides carry the exact numbers, one self-contained file per surface, written so both people and LLMs can build from them without anything else open.

Guides

• Print and PDF

  Proposals, one-pagers, posters. #825FFF sits outside coated CMYK gamut: managed conversion or spot colour, press proof before official use.

• Slides

  16:9 decks. 24 pt body minimum, 30 to 32 pt for a 6 m room. One idea per slide.

• Kiosk, large-format touch

  Public kiosks 32 to 55 in portrait. Targets are physical: 20 mm minimum, 26 mm preferred, resolved to px per panel. Author in mm, never hardcode px.

• PDA touch (Zebra TC27 class)

  Staff and vendor handheld. 6.0 in, 403 ppi, 450 nit: gloved targets need about 60 dp, not 48 dp.

• Mobile info app

  Visitor phone app. 44 pt / 48 dp targets, Dynamic Type with the 600 weight cap (600 is semibold, bold is banned).

• Web copy

  Marketing and long-form web. Measure 45 to 75 ch (66 ideal). #825FFF fails AA for body text on white; #7351EF is the reading purple.

For LLMs

The machine index lives at /llms.txt. It follows the llmstxt.org convention: fetch it first, follow the link to the guide for your target surface, and every hex, px, pt, mm and dp value you need is inline. Guides are served as raw markdown, no rendering required.

Token contracts

Generated platform contracts, fetchable by URL. Source of truth is tokens/ludo.tokens.json; never edit generated files by hand.

• tokens.css
• tokens.rn.ts
• tokens.mui.ts
• tokens.computer.ts
• tokens.compose.kt
• tokens.swift

The Compose and Swift contracts ship with sha256 files alongside them for copy-sync integrity, the same pattern ludo-computer uses.