---
title: "Pilot Frontend and Console"
canonical: "https://pilot.docs.mindburn.org/frontend"
source: "pilot/docs/frontend.md"
edit: "https://github.com/Mindburn-Labs/pilot/edit/main/docs/frontend.md"
section: "frontend"
access: "public"
sensitivity: "public"
last_reviewed: "2026-05-18"
checksum_sha256: "sha256:63194d3ed7b4ae44fc901ae098f04f71b2af497af1e32f977c093d5a914543b7"
build_timestamp: "2026-05-24T13:42:52.320Z"
---
# Pilot Frontend and Console

This page is the public frontend map for Pilot. It covers user-facing surfaces
and points readers to the implementation paths that own behavior.

## Source truth

- Web application shell and founder workflows: `apps/web/README.md` and
  `apps/web/src/app/`.
- Telegram Mini App behavior: `docs/telegram-miniapp-8.md` and
  `apps/telegram-miniapp/README.md`.
- Telegram bot behavior: `apps/telegram-bot/README.md`.
- Public workflow routes and capability labels: `docs/capabilities.md`,
  `docs/pilot-capability-matrix.md`, and the shared capability registry.
- API payloads used by UI surfaces: `docs/api.md`.

## Frontend boundary

Pilot frontend docs may describe available screens, route families, and the
state each screen reads. They must not promote prototype or implemented
capabilities to production-ready unless the shared registry and evidence-backed
evals have already promoted the capability.

## Surface map

```mermaid
flowchart TD
    subgraph Ingestion["1. Ingestion & Context Plane"]
        Founder["Founder or operator"]
        Web["apps/web"]
        Telegram["Telegram bot and mini app"]
    end

    subgraph Evaluation["2. Evaluation & Policy Plane"]
        Gateway["Gateway API"]
    end

    subgraph Ledger["4. Tamper-Evident Ledger Plane"]
        State["Workspace, task, evidence, and capability state"]
    end

    %% Operational Flow Edges
    Founder --> Web
    Founder --> Telegram
    Web --> Gateway
    Telegram --> Gateway
    Gateway --> State
    State --> Web

    %% Premium Styling Rules
    style Gateway fill:#2d3748,stroke:#4a5568,stroke-width:2px,color:#fff
    style State fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff
```


## Validation

Run `npm run docs:coverage && npm run docs:truth` before changing frontend docs.
Run the relevant web or Telegram package checks when a UI claim depends on
actual route behavior.