Maps — playlists for your learning

A Map is an ordered list of references to Trails and Quizzes plus a small wrapper (title, description, optional cover, optional theme). It carries no content of its own — you cannot quiz inside a Map, you cannot earn XP from "the Map", and the AI is never asked to draft Map content. XP and progress all come from the underlying items.

• ✅ A personal roadmap — "the 8 trails I want to do this quarter to learn Rust".
• ✅ A curated playlist for your followers — "Best cooking trails for beginners".
• ✅ A study guide — "Everything to revise for the exam, in order".
• ❌ Not a sequential curriculum — item order is a recommendation, never a gate.
• ❌ Not a content layer — if you want new lessons, create a Trail, not a Map.
• ❌ Not nestable — a Map cannot contain another Map.

From the top nav, open the `+ Create ▾` menu and pick `Create a Map`. You’ll land on a blank Map detail page with an empty items list. Set a title (1–80 chars), an optional description (up to 500 chars), and hit `Add items` to start populating.

The add-items dialog lets you pick from your own Trails / Quizzes (private or public) and any other Explorer’s public Trails / Quizzes. Search is full-text and scoped to what you can actually add. Drag the position handles in `Edit mode` to reorder — the position numbers re-stamp automatically.

Maps mirror Trails and Quizzes: three visibility states with the same lifecycle.

• Private — only you can see the Map. Default for every new Map.
• Public — anyone with the link (and `/explore/maps` once we promote it) can open the Map detail page. Required if you want to feature, share on socials, or accept saves / clones.
• Curated — a public Map promoted by the Yoonle team to the `/explore/maps` rail. You cannot self-promote; the editorial team flags Maps that meet the bar (well-ordered, coherent topic, public items all the way through).

When you view someone else’s public Map, the `⋯` menu on the page gives you two verbs:

• `Follow Map` — a lightweight bookmark. The Map appears in your dashboard’s "Followed Maps" lane and you get a chip when the owner adds new items. The Map stays owned by the original Explorer; you only get read-through.
• `Duplicate Map` — a full fork. A new Map is created in your account with copied item references and a `Cloned from @username` attribution. The cloner is now the owner and can edit, reorder, remove items, change visibility — independently of the original.

Maps follow the same generous-Free / capable-Pro split as the rest of Yoonle.

• Free — up to 3 Maps total, max 1 of them public (or all 3 private). Each Map holds up to 20 items. Auto-generated cover (a gradient blended from your items’ categories) and the default earth theme.
• Pro — unlimited Maps, unlimited items per Map, custom cover upload (same Azure Content Safety screening as profile avatars), custom theme picker (earth / trail / forest / coral / ink), and PDF + Markdown export.

A Map’s completion is purely item-count: completed items / total live items. Items don’t earn extra XP for being in a Map — you earn the underlying Trail’s and Quiz’s XP exactly as if you’d opened them directly. Completing a Map (every item finished) does award an achievement on the first time, similar to finishing a long Trail.

When an item in a Map becomes unavailable (the owner deletes their Trail / flips it private), the row renders a tombstone explaining the change. Owners see a `Remove from Map` quick action and a notification; followers see a quiet placeholder until the owner cleans up.

Every public Map page has a Share menu (copy link / socials / export). Free can share the link and screenshot socials; Pro can additionally export the Map as PDF or Markdown — both include the full item list with their description, category, and direct links back to the original Trail / Quiz.

Export is completion-gated, just like Trails and Quizzes: 100% complete required, owners included. The aim is the same — an exported Map should be a record of a finished thing, not a wishlist.

On your dashboard, the Maps stat chip rolls up your total. The "Your Maps" lane lists the ones you own; the "Followed Maps" lane lists the ones you follow.

On any public profile (`yoonle.com/u/<username>`), a Maps tab next to Trails / Quizzes / Achievements lists that Explorer’s public Maps.

On `/explore`, the curated-Maps widget shows four hand-picked Maps the team is highlighting. The dedicated `/explore/maps` page lists the full curated catalog.

On every Trail / Quiz, the `⋯` overflow has a `Find Maps with this` shortcut so you can jump to public Maps that already include the item.