AI compatible · works today
Create a trip with an AI
Roadbook is plain JSON with English tokens and a public specification, so any capable assistant (Claude, ChatGPT, Gemini, Perplexity, a local model…) can produce a valid file from a conversation. No plugin needed: describe your trip below, copy the generated prompt — or open it directly in your assistant — then validate and play.
works with any LLM
spec URL roadbookformat.org/spec.html
loop generate → validate → fix
Prompt builder#
Answer four short questions — travelers, dates & cities, style, extras — and get a prompt tuned to your trip.
Your prompt#
Assistants with web access fetch the spec themselves; for offline models, paste the JSON Schema after the prompt.
Validate, then fix#
| Step | |
|---|---|
1 | Paste the model's answer into the validator (nothing leaves your browser). |
2 | If it reports errors, paste them back to the model verbatim: "Fix these validator errors and return the full corrected JSON: …". Errors are path + message pairs written for exactly this. |
3 | Hit Preview trip to eyeball it, download it as my-trip.roadbook.json, then open it in a player. |
Tips for better results#
- Give facts, not vibes. Dates, arrival times, hotel area, dietary needs, kids' ages: the model turns them into
memberIds,dietary,outfit,criticalnotes. - Ask for the structure you will use. Business trip? The builder adds
payer,paymentandmeetingitems. Agency package? Ask forpeople(guides, drivers) linked throughpersonIds. - Iterate on the JSON, not on prose. "Move the boat tour to day 2 at 15:00 and add a rain alternative" — the model rewrites the entity, you re-validate.
- Media stays out of the file. Ask for URLs in
image/voucher, never inline base64. - Long trips (2+ weeks): generate day by day or week by week, then merge — a valid roadbook is just arrays of days.
For agents and tool builders#
/llms.txt— canonical URLs of the spec, schema, validator and examples, for AI crawlers and agents.roadbook.schema.json— usable as a structured-output / function-calling schema (draft 2020-12).roadbook-validate.mjs— zero-dependency validator to run server-side before persisting a model's output.- Conversational authoring tools (assistant, MCP) live on the official player side.