Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

# nav Card

# Nav Card

`nav.card` at the box root adds the box's own entries to the app bar's place menu (the one that opens from the box ▸ landmark pill). Editing it reshapes that section immediately — no deploy. When the card is absent or invalid, the menu shows only its builtin rows, and an invalid card also raises a health warning naming the problem. Deleting the card is always a safe way back to stock navigation.

Entries pointing at a destination the menu already reaches (`/`, `/chat`, `/chats`, `/landmarks`, `/browse`, `/history`, `/dashboard`) are skipped rather than shown twice — pin cards and the less-travelled routes.

```yaml
entries:
  - { href: /questions }       # builtin routes, validated against the route set:
  - { href: /capture, label: Quick capture }   # /, /chat, /dashboard, /chats, /questions, /browse, /landmarks, /history, /capture, /settings, /admin
  - { ref: /_content/projects/Big_Refactor.project.card, label: The Refactor }
```

- **`href`** — a builtin route. `label` defaults to the route's standard name.
- **`ref`** — any card, by box path (leading `/`, from the box root); it opens in Browse. `label` defaults to the target's title. Use this to pin a card (a project, a list, a note) into the menu.

Keep the list short — this is a menu section, not a directory. Order is display order.