---
category: spec
tags: [ux, navigation, platform, plan]
last_updated: 2026-03-17
confidence: high
---

# Wiki-to-Dashboard Navigation Plan

Add a "Dashboard" link in Otterwiki's dropdown menu so users can navigate back to the platform dashboard from within their wiki.

## Approach

Add to the `⋮` dropdown menu in `wiki.html`'s `{% block navbardropdown %}`, at the top, separated by a divider. PLATFORM_MODE-only. Uses `os_getenv('PLATFORM_DOMAIN')` (already a Jinja2 global) for the URL — no resolver changes needed.

## Visual placement

```
[ ⋮ dropdown ]
  ← Dashboard            (PLATFORM_MODE only)
  ─────────────────
  Create page
  A - Z
  Changelog
  ...
```

## Link details

- Text: **"Dashboard"**
- Destination: `https://{{ os_getenv('PLATFORM_DOMAIN', 'robot.wtf') }}/app/`
- Icon: `fas fa-th-large`
- Guard: `{% if config.PLATFORM_MODE %}`

## Files to Modify

| File | Change |
|---|---|
| `otterwiki/templates/wiki.html` | Add Dashboard link at top of `{% block navbardropdown %}` |

One file. No resolver changes, no new proxy headers, no new config keys. `PLATFORM_DOMAIN` is already in `robot.env`.

## Test Plan

In `tests/test_platform_mode.py`:
1. `test_dashboard_link_shown_in_platform_mode` — Dashboard text + `/app/` href present in dropdown
2. `test_dashboard_link_hidden_without_platform_mode` — Dashboard not present
3. `test_dashboard_link_points_to_platform_domain` — href contains configured domain