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

# Dashboard

> Real-time TUI dashboard for monitoring strategies with Textual. Live feeds, positions, orders, and PnL.

Horizon includes a real-time TUI (Terminal User Interface) dashboard built with [Textual](https://textual.textualize.io/). It displays P\&L, positions, orders, risk status, fills, and feeds in a 2x3 grid layout.

## Enable the Dashboard

```python theme={null}
hz.run(dashboard=True, ...)
```

Or from the CLI:

```bash theme={null}
python -m horizon run strategy.py --dashboard
```

## Panels

The dashboard displays 7 panels in a 2x4 grid:

| Panel         | Content                                                           |
| ------------- | ----------------------------------------------------------------- |
| **P\&L**      | Realized, unrealized, total, and daily P\&L with equity sparkline |
| **Positions** | Market, side, size, entry price, P\&L color-coded (up to 10)      |
| **Orders**    | Open orders with side, price, size, market (up to 10)             |
| **Risk**      | Position count, order count, kill switch status, uptime           |
| **Fills**     | Recent fills with side, size, price (last 10)                     |
| **Feeds**     | Feed names, bid/ask spread, staleness indicator                   |
| **Alerts**    | Recent alerts (stale feeds, lifecycle events, state changes)      |

## Keybindings

| Key | Action                          |
| --- | ------------------------------- |
| `q` | Quit the strategy               |
| `k` | Toggle kill switch on/off       |
| `p` | Pause/Resume strategy execution |

## How It Works

The dashboard runs the strategy loop inside the Textual app's timer:

1. A `set_interval(interval)` timer fires each cycle
2. Each tick: poll fills → update P\&L → run pipeline → process results → update panels
3. Positions are snapshotted to the database every 50 ticks
4. All 6 panels are refreshed after each tick

The dashboard uses the same `_build_context()`, `_run_pipeline()`, and `_process_result()` functions as the console mode. Same strategy logic, different display.

<Note>
  The dashboard requires `textual>=0.40`. If not installed, Horizon falls back to console mode with a warning message.
</Note>

## Dashboard vs Console Mode

| Feature            | Console                   | Dashboard                 |
| ------------------ | ------------------------- | ------------------------- |
| Strategy execution | Same                      | Same                      |
| Status output      | Every 10 cycles to stdout | Real-time panels          |
| Kill switch        | Not accessible            | Press `k` to toggle       |
| Pause/Resume       | Not available             | Press `p` to toggle       |
| Quit               | `Ctrl+C`                  | `q` or `Ctrl+C`           |
| Feed display       | Logged at debug level     | Live panel with staleness |
| Alerts             | Logged to console         | Dedicated alerts panel    |