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.
See data modelPlot. Navigate. Validate. Standardize.
OpenRoadBook is the open standard for rally and adventure navigation. Built for clarity and interoperability, it defines a precise schema, signage-inspired marks, and robust validation for every stage.
What OpenRoadBook provides
The project 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.
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.
Browse symbolsValidation & tooling
CLI tooling validates YAML, exports GPX, and renders printable layouts. The next wave adds scrutineering automation, conversion pipelines, and digital navigation sync.
Validation guidanceIntended audience
The format is intended for event organizers, competitors, software developers, and tool builders who need a shared, machine-validated description of stages and instructions. Profiles let the same base format meet different assurance and compliance 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 nav and partner integrations tomorrow.
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.
Explore the formatQuick start
A runnable walkthrough: download the demo file, validate it, edit, and export. Ideal for getting started.
Try the quick startSpecification
Draft requirements, profile hooks, and compliance guidance as we grow toward FIA support.
Read the specDemo roadbook
Explore a sample roadbook, download the ORB file, and validate it against the published schema.
View the walkthroughCommunity roadmap
Priorities for validation tooling, hazard registry expansion, and competitive rally features.
View initiativesContributing & 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.