> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roveflow.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlas format

> The journeys.json file that defines your map.

The Atlas is built from one small file, `roveflow-out/journeys.json`. The autopilot writes it for you, and you can edit it by hand to rename things, reorder flows, or group screens into journeys.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "app": "Acme",
  "platform": "ios",
  "subtitle": "your tagline",
  "screens": {
    "home":   { "title": "Home",    "caption": "the daily view" },
    "signup": { "title": "Sign up", "caption": "create an account" }
  },
  "journeys": [
    {
      "category": "Onboarding",
      "title": "Create an account",
      "description": "From the welcome screen through to the home feed.",
      "flow": ["welcome", "signup", "home"]
    }
  ]
}
```

* **`screens`**, every screen, keyed by a short id. Each id needs a matching image at `roveflow-out/screens/<id>.png`.
* **`journeys`**, the flows. Each `flow` is a list of screen ids in order. Every id must exist in `screens`.
* **`category`**, colors the journey. Use: `Onboarding`, `Tracking`, `Discover`, `Profile`, `Settings`, `Messaging`, `AI`, `Scenario`.

After editing, rebuild:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
roveflow atlas
```

You get `atlas.html`, a single page with your journeys in the sidebar, screen tiles wired into each flow, and a short video per journey.