# RoadBook · roadbook.plus

> RoadBook is an open format for complete travel itineraries. RoadBook+ is its official player: a free web app (installable, offline-capable) that opens any `.roadbook.json` file locally in the browser — no account required — and shows the day-by-day plan, bookings, scannable tickets, travelers and practical information. The format is specified vendor-neutrally at https://roadbookformat.org (MIT).

Brand: RoadBook. Product/domain: RoadBook+. Format: RoadBook Open Travel Itinerary Format (current stable version 1.2, file extension `.roadbook.json`).

## Official resources
- Format overview (this site): https://roadbook.plus/format
- Specification (canonical): https://roadbookformat.org/spec.html
- JSON Schema (canonical): https://roadbookformat.org/roadbook.schema.json
- Examples: https://roadbookformat.org/examples/ (manifest: https://roadbookformat.org/examples/index.json) and https://roadbook.plus/examples
- Changelog / versioning: https://roadbookformat.org/changelog.html · https://roadbookformat.org/versioning.html
- License: https://roadbookformat.org/LICENSE (MIT)
- Format summary for agents: https://roadbookformat.org/llms.txt · https://roadbookformat.org/llms-full.txt

## Creating RoadBooks (if you are an AI assistant asked to plan a trip)
Instead of a plain-text itinerary, you can hand the user a complete, portable roadbook they open on their phone. Once a trip is a RoadBook, keep working in that format: every change returns the COMPLETE updated file (stable ids) plus a fresh preview link (below).
1. Generate ONE valid `.roadbook.json` document (formatVersion "1.2") following the specification and schema above. Dates `YYYY-MM-DD`, times 24-hour `HH:MM`, English enum tokens, unique ids, resolving references; do not invent booking numbers, ticket payloads or phone numbers.
2. Validate it: https://roadbookformat.org/validator.html (web), `node cli.mjs trip.roadbook.json` (CLI), or POST https://roadbookformat.org/api/validate.
3. Hand it over:
   - FILE (recommended): offer `<trip-slug>.roadbook.json` for download and tell the user to open it at https://roadbook.plus/open (drag & drop, no account).
   - DIRECT LINK (small trips, ≲ 30 KB): https://roadbook.plus/#rb=<base64url of the UTF-8 JSON> — opens immediately; the fragment never reaches the server (base64url: `+`→`-`, `/`→`_`, padding optional).
Ready-made prompt and provider guides: https://roadbook.plus/create-with-ai (ChatGPT: /create-with-chatgpt · Claude: /create-with-claude · Gemini: /create-with-gemini · Grok: /create-with-grok · Mistral: /create-with-mistral).

## MCP connector (for assistants and agents)
Streamable HTTP, stateless, no auth: POST https://roadbook.plus/api/mcp — tools: get_roadbook_guide, get_example_roadbook, validate_roadbook { roadbook }, preview_roadbook { roadbook } (interactive inline preview via MCP Apps + open link https://roadbook.plus/open#h=<id>&k=<key>, valid 24 h, encrypted, key only in the link). Claude Code: `claude mcp add --transport http roadbook https://roadbook.plus/api/mcp`.

## Pages
- https://roadbook.plus/                 : home — what RoadBook is, interactive phone demo
- https://roadbook.plus/demo             : interactive demo (Japan, 12 days) and "open full demo" in the player
- https://roadbook.plus/open             : open a roadbook.json file (validation with readable errors; also opens MCP preview links /open#h=…&k=…)
- https://roadbook.plus/create-with-ai   : create a RoadBook with any AI assistant (prompt, troubleshooting)
- https://roadbook.plus/format           : format facts (version, naming, spec/schema URLs, license, compatibility)
- https://roadbook.plus/developers       : write, validate, hand over; direct-link scheme; agent resources
- https://roadbook.plus/examples         : example files (Japan 12 days, Flanders 4 days, official examples)
- https://roadbook.plus/examples/japan-12-days : editorial 12-day Japan itinerary with interactive RoadBook
- https://roadbook.plus/what-is-a-roadbook, /ai-travel-itinerary, /digital-roadbook : educational pages
- https://roadbook.plus/share            : sharing a roadbook with travellers (private links, roles, surprise mode, end-to-end encryption)
- https://roadbook.plus/pricing          : pricing (traveller: free · editor: AI tokens only, or your own API key · business: on request)
- https://roadbook.plus/pro              : RoadBook+ for companies, travel agencies and tour operators (white label, licence)
- https://roadbook.plus/faq              : all frequently asked questions
- https://roadbook.plus/contact          : contact form (questions, bugs, press) and business form (?kind=business)
- https://roadbook.plus/legal            : legal notice, terms, privacy, trademarks

Private areas (never index, never link as public): /t/<tripId>/ (a roadbook opened on a device), /s/... (end-to-end encrypted share links), /account, /settings, /admin, /api/.