> ## 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.

# Journeys and screens

> Shape the Atlas by editing journeys.json, add screens, rename them, and group them into journeys.

The Atlas is built from one file: `roveflow-out/journeys.json`. It lists every screen and the journeys that connect them. Edit it to rename screens, fix captions, or reorder the flows, then rebuild.

## The file

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "app": "Acme",
  "platform": "ios",
  "subtitle": "tagline",
  "screens": {
    "home": { "title": "Home", "caption": "short note" }
  },
  "journeys": [
    {
      "category": "Onboarding",
      "title": "Sign up",
      "description": "...",
      "flow": ["home", "signup", "done"]
    }
  ]
}
```

* **screens**, each key is a screen id. Give it a `title` and a short `caption`.
* **journeys**, each one has a `category`, a `title`, a `description`, and a `flow`: the list of screen ids a user moves through, in order.

## The one rule

Every id in a journey's `flow` must:

1. Be a key in `screens`, **and**
2. Have a captured image at `roveflow-out/screens/<id>.png`.

If an id is missing either, that step won't show up in the Atlas.

## Rename a screen

Change its `title` or `caption` under `screens`. The id stays the same, so your journeys keep working.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
"home": { "title": "Dashboard", "caption": "where users land after login" }
```

## Add a journey

Pick a category, write a title and description, and list the screen ids in order.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "category": "Tracking",
  "title": "Log a workout",
  "description": "How a user records activity",
  "flow": ["home", "track", "summary"]
}
```

## Categories

Each category gets its own color in the Atlas. Use one of:

`Onboarding` · `Tracking` · `Discover` · `Profile` · `Settings` · `Messaging` · `AI` · `Scenario`

## Rebuild

After any edit, rebuild the Atlas so your changes show up.

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