Ecosystem · players & viewers
Where to open a roadbook
A .roadbook.json file is meant to be played: tickets rendered as scannable codes, one view per traveler, offline on the road. These applications read the format. Any of them may advertise itself as "Roadbook ≤ 1.2 compatible" once it follows the player obligations.
Official player#
Roadbook — reference player & builder
The reference implementation the specification is validated against. Installable offline-first PWA: today / trip / tickets / info tabs, per-traveler links with roles (owner, editor, viewer), scannable QR / Code 128 tickets and vouchers, surprise mode for kids, "what to wear today", plan B and on-site options, sync between phones, in-app editing, import / export of .roadbook.json, and an AI assistant that edits the trip from a conversation.
spec ≤ 1.2platform web · PWAoffline yesimport .roadbook.jsonstatus private beta
The player is in production use on real trips but not yet open to the public. When it is, anyone will be able to load their own .roadbook.json and the link will appear here. Public sign-up, hosted trips and the AI/MCP authoring tools live on the player side, not on this specification site.
Minimal preview#
This site ships a deliberately plain, read-only renderer (roadbook-view.mjs, MIT) used by the validator's Preview trip button — enough to eyeball a file, not to travel with it. Try it: open the demo in the validator with preview.
Compatible viewers#
| Name | Platform | Spec | Notes |
|---|---|---|---|
| — none listed yet — | Be the first: submit yours below. |
Submit a compatible viewer#
Built a player, a viewer, an importer or a generator that reads or writes this format? We list tools that load the demo file without error and follow the player obligations.
Building your own?#
- Start from the spec and the JSON Schema; run the validator on every file you write.
- Follow the three player obligations: ignore and preserve unknown fields, advertise the highest version you fully implement, write the version you actually emit.
- Tickets: render
payloadwith the declaredformat(qr, code128, pdf417, aztec, ean13, datamatrix) — the code must scan. - Media are URLs: fetch and cache them for offline use; never expect inline files.
- Reuse
roadbook-view.mjsas a starting point for a read-only rendering — MIT, no dependencies.