crumb

An open format for trip itineraries

A list of a few cities, or a fully timed schedule with every activity. You add detail as plans take shape.

It's just text

The map above comes from this plain-text file, written in YAML with a handful of simple fields.

You can read it in any text editor, keep it in a folder, or send it to a friend like any other message.

The format was designed with half-formed plans in mind, so details and dates can stay as vague as yours, and it still works out a timeline.

Read the documentation
japan-planning.crumb
trip:
  name: Planning Japan
  author: Claudio
  duration: 10 nights
  tags: [japan, first-time, food, temples]
  note: Coming together. Flying into Tokyo, out of Osaka. Still need to book hotels and the shinkansen.

itinerary:

  - place: Tokyo
    arrives: early October
    duration: 4 nights
    plan:
      - Senso-ji Temple
      - activity: teamLab Planets
        priority: must
      - Shibuya Crossing
      - Tsukiji Outer Market
      - activity: Day trip to Nikko
        priority: maybe
        location: Nikko, Tochigi

  - transport: train      # shinkansen to Kyoto

  - place: Kyoto
    duration: 3 nights
    plan:
      - activity: Fushimi Inari
        priority: must
      - Arashiyama Bamboo Grove
      - Kinkaku-ji
      - activity: Gion in the evening
        location: Gion, Kyoto

  - transport: train

  - place: Osaka
    duration: 3 nights
    plan:
      - activity: Dotonbori
        priority: must
      - Osaka Castle
      - Kuromon Market
      - activity: Day trip to Nara
        priority: maybe
        location: Nara

Different ways of using it

The same format carries a city guide, a weekend away, or months on the road.

And it isn't bound to one look. The same crumb can be displayed as one large interactive map, or a list of small cards like these.

Because the format is open, you can build any other view you imagine.

Give it a try

A few ways in, for travelers and builders alike.

Generate one with AI
A crumb is just plain text with a simple vocabulary, so an AI can write a whole itinerary from a chat. Give it the format guide and describe your trip.
The AI authoring guide
Open it in the live editor
Paste a crumb, yours or one an AI wrote, and watch it turn into a live map and timeline as you type. Load existing files and save your edits back out.
Live editor
Embed it anywhere
A crumb's interactive map is fully self-contained, so you can drop it into your own site or blog as a single HTML embed, with nothing to set up.
How to embed
Build your own view
Build a brand-new way to display a crumb, or extend an existing one into the view you have in mind. The format is fully specified, with a reference parser to build on.
Spec & parser reference