# Open Meet Exchange (OMX), version 1.0

> A JSON document format for handing a track meet, cross country meet, or road race forward from Registration to Meet Operations to a Publisher. One document per meet, the same schema at every handoff. From 1.0 a minor version only adds and only a major breaks.

Read the raw files, not the rendered pages. Cite the pinned copies under https://2timer.app/omx/1.0/ so your implementation names the exact version it was built against; the unversioned URLs follow the newest version.

## Files

- [spec.md](https://2timer.app/omx/1.0/spec.md): The specification: roles, the document, reading, handing off, security, versioning
- [conformance.md](https://2timer.app/omx/1.0/conformance.md): Conformance tests OMX-C1 onward, each with a check and a pass condition, grouped by role
- [integration-prompt.md](https://2timer.app/omx/1.0/integration-prompt.md): Prompts for a coding assistant: build Registration, publish a meet, or add OMX to a Meet Operations product
- [mapping.md](https://2timer.app/omx/1.0/mapping.md): Where Hy-Tek, RunSignup, and Athletic.net fields go in a document
- [examples.md](https://2timer.app/omx/1.0/examples.md): The worked examples, one per sport, each with its results twin
- [schemas/meet-document-v1.schema.json](https://2timer.app/omx/1.0/schemas/meet-document-v1.schema.json): Reader schema, JSON Schema draft-07, lenient: validate what you receive
- [schemas/registration-document-v1.schema.json](https://2timer.app/omx/1.0/schemas/registration-document-v1.schema.json): Strict schema for a registration document (omx.kind registration), as Registration writes it
- [schemas/results-document-v1.schema.json](https://2timer.app/omx/1.0/schemas/results-document-v1.schema.json): Strict schema for a results document (omx.kind results), as Meet Operations hands it off
- [schemas/destination-card-v1.schema.json](https://2timer.app/omx/1.0/schemas/destination-card-v1.schema.json): Schema for a destination card a Publisher gives a timer
- [tools/omx-check.mjs](https://2timer.app/omx/1.0/tools/omx-check.mjs): Checker, Node 18+, no dependencies: node omx-check.mjs --kind results meet.omx.json
- [tools/omx-validators.mjs](https://2timer.app/omx/1.0/tools/omx-validators.mjs): The four schemas compiled to plain JavaScript (meetDocument, registrationDocument, resultsDocument, destinationCard); put it beside omx-check.mjs and the checker validates with no install
- [fixtures/index.json](https://2timer.app/omx/1.0/fixtures/index.json): Crafted documents for the conformance tests, with expected outcomes
- [types/omx.d.ts](https://2timer.app/omx/1.0/types/omx.d.ts): TypeScript types generated from the schema
- [types/omx.py](https://2timer.app/omx/1.0/types/omx.py): Python 3.11 TypedDicts generated from the schema

## Pages

- [Open Meet Exchange](https://2timer.app/omx): an overview of what the format is and where to start
- [Specification](https://2timer.app/omx/spec): the rendered specification; read spec.md above instead
- [Test page](https://2timer.app/omx/test): check a document, a registration URL, a Publisher endpoint, or a destination card from a browser
- [Field reference](https://2timer.app/omx/reference): every schema field as tables