Plan. Validate. Publish. Navigate.
OpenRoadBook is an open standard for rally and adventure roadbooks. Built for clarity and interoperability, it defines a precise schema, signage-inspired marks, and provides reference validation and publishing.
- Today: Adventure-ready schema, signage-based marks, and open validation tools.
- Next: FIA-aligned profiles, richer hazard taxonomy, digital nav integrations.
- Future: Partner dashboards, telemetry, pro rally extensions.
Contributing & governance
The project is community-driven. Contributions that improve the registry, validation coverage, converters, or documentation are welcome. Governance and versioning policies are documented in the repository.
Publish open symbols
Crowdsource clean-room SVGs, license them openly, and grow the registry so adventure and FIA events share the same icon language.
Ship validation
Expand JSON Schema coverage, wire it into CI, and block releases until entries, CAPs, hazards, and partner data validate.
Build converters
Extend CORBS-style tools that turn OpenRoadBook YAML into FIA-style PDFs, GPX/KML exports, and digital dashboards.
Document examples
Publish sample roadbooks, rendered outputs, and quick-start guides so new organizers adopt the schema with confidence.
Coordinate stewardship
Form a working group that keeps versioning transparent, reviews proposals, and aligns adoption with adventure and competitive rally needs.
Organizers
Publish adventure stages with predictable layouts, symbols, and exports now—then adopt scrutineering data, penalties, and timing as the FIA profile lands.
Competitors
Practice on legible, signage-inspired roadbooks today and stay aligned with the future competitive format when you step into pro events.
Software developers
Parse structured entries, export GPX, and integrate with basic dashboards now—then plug into telemetry, scoring, and compliance services as the schema expands.
Tool builders
Align dashboards, printers, and visualization tools to one file today, and extend to pro-grade digital navigation and partner integrations tomorrow.
What OpenRoadBook provides
The standard specifies a clear file structure, a symbol registry, and a validation surface so authors and tools can exchange roadbooks reliably. The current release targets adventure and non-competitive events while providing extension points for competitive profiles.
- Canonical YAML structure (with JSON equivalents) for human and machine use.
- Reference tooling and templates for validation, export, and rendering.
- Example roadbooks that serve as templates and test fixtures.
- Versioned extension points so higher-assurance profiles (e.g., FIA) can be added compatibly.
Design principles
OpenRoadBook focuses on predictable structure, explicit units, and stable identifiers so data can be validated, rendered, and transformed by independent tools without losing meaning.
Structured data model
Define distance, CAP, tulips, hazards, and attachments with predictable types. Upcoming profiles add timing, penalties, and pro rally metadata without breaking compatibility.
Symbol registry
Reference hazards, services, and surfaces by ID using open SVG assets. Roadmapped updates expand the registry for FIA sites, competitive hazards, and localization.
Validation & tooling
CLI tooling validates YAML, exports GPX, and renders printable layouts. The next wave adds scrutineering automation, conversion pipelines, and digital navigation sync.
Primary resources
Start with the format overview to learn the file layout and symbol registry. Use the specification for normative rules and validation requirements, and the demo roadbook as a working template.
Format overview
Symbols, schema anatomy, and implementation notes for the current adventure release.
Quick start
A runnable walkthrough: download the demo file, validate it, edit, and export. Ideal for getting started.
Specification
Draft requirements, profile hooks, and compliance guidance as we grow toward FIA support.
Demo roadbook
Explore a sample roadbook, download the ORB file, and validate it against the published schema.
Community roadmap
Priorities for validation tooling, hazard registry expansion, and competitive rally features.