Release history

Changelog

Every release of the specification, the JSON Schema and the reference validator — the three always move together. Rules: versioning policy.

1.2 — 2026-08-08 · stable#

Theme: universality — flights, transfers, people on site, vehicles, business trips, agency packages.

Additions (all optional)

• IANA timezone on trip, day, item (timezone / endTimezone) and transport points; times remain local wall-clock; endDate on items for D+1 arrivals.
• coords on items and options.
• New root entities: people (Person — guides, drivers, hosts: photo, messaging, languages, recognition sign) and vehicles (Vehicle — kind, energy, plate, rental).
• TransportDetails (carrier, number, ref, from/to with terminal, gate, platform, timezone, vehicleId) on items and bookings; route.vehicleId on days.
• memberIds / personIds on items and bookings; Ticket.memberId.
• Tickets: date, time, seat, validUntil; barcode formats pdf417, aztec, ean13, datamatrix.
• Stays: checkin, checkout, breakfastIncluded, rooms (with occupants).
• payment (status: prepaid / deposit / onsite / invoice; deposit; payer: personal / company; note) and priceEstimated on items and bookings.
• Members: phone, email, loyalty, dietary, accessibility.
• Item-level attachments; outfitNote (free-text outfit details, 2026-08-19).
• 18 new item types: event, nightlife, wellness, viewpoint, tasting, ferry, transit, transfer, bike, walk, fuel, break, laundry, admin, medical, work, meeting, conference (34 in total).
• Times standardized on 24-hour "HH:MM" (2026-08-08): legacy "9h"/"9h30" forms are rejected by the validator with a hint.
• Root brand (2026-08-20): distributor branding with an Ed25519 signature binding the trip id to the brand; unlicensed players ignore the theme and may show "by <name>".
• critical clarified as a warning text, never a boolean (2026-08-22).

Deprecations

• None. Member.surprise (boolean, 1.0) remains deprecated in favor of surpriseMode.

Compatibility

• Additive: every valid 1.0 or 1.1 file is a valid 1.2 file. A 1.0/1.1 reader displays a 1.2 file minus the fields it does not know, and must preserve them when rewriting.
• Writers using any 1.2 field must declare "formatVersion": "1.2".

1.1 — 2026-08-07 · stable#

Additions (all optional)

• menuUrl on DayItem, ItemOption and Booking.
• outfit (recommended outfit / gear tokens) on DayItem.
• price + currency (ISO 4217) on DayItem and Booking; trip-level default currency (absent = EUR) — enables budget aggregation.

Deprecations

• None.

Compatibility

• Additive; 1.0 readers ignore the new fields.

1.0 — 2026-08-04 · stable#

Initial release

• Trip, members with roles (owner / editor / viewer) and surprise mode, days and items (16 types), conditional fallbacks (alternatives), on-site choices (options), bookings, QR / Code 128 tickets carrying their real payload, vouchers, checklists, contacts, logistics notes, useful apps.
• English enum tokens and field names throughout; French pre-release tokens are recognized by the validator and mapped to hints.
• Rule: readers ignore and preserve unknown fields.

Deprecations

• Member.surprise (boolean) → surpriseMode.

How releases work#

MINOR releases add optional fields and values only. MAJOR releases may break compatibility and will be announced with a migration note. Proposed changes are discussed before landing in a new release of the specification, the schema and the validator. See versioning.