Dashboard

The Sophon Dashboard is a React 19 + TypeScript web app served by the Gateway at http://<gateway>:8080/ (default). It's the primary place you'll spend time in Sophon: chat lives there, agent management lives there, workflows are built there, approvals land there, and every setting has a screen.

This page is a map of the Dashboard so you know where things are.

Top-level navigation

The Dashboard has a left sidebar and a top header. The sidebar groups pages into sections:

• Home — personalized feed with insights, daily thought, AI summary, active tasks
• Chat — active sessions and new chat
• Agents — manage your agents
• Workflows — build, list, edit, run
• Skills — installed skills, marketplace, per-agent toggles
• Memory — entries, logs, search, entity graph
• Documents — library, upload, Q&A
• Tasks — active + history ledger
• Canvas — live code/artifact editor (opens automatically from chat)
• Claude Code — sandboxed coding sessions
• Discussions — multi-agent deliberation (Preview)
• Voice — voice interaction surface
• Approvals — pending approval queue
• Admin (Admin role only) — Users, Roles, Audit, License, Compliance, Tenants
• Operations (Operator role) — System, Control, Remote Access
• Settings — everything that doesn't fit elsewhere

Per-page detail

Home

The landing page after login. Shows:

• Hero greeting with your streak and token budget
• Daily thought (rotating curated quote)
• AI-generated summary of your week
• Insight cards (activity trends, tool usage, milestones)
• Active tasks card (live-updating via SignalR)
• Recent sessions
• On-this-day reflection (1 year / 1 month / 1 week ago)

See Insights.

Chat

Left panel lists sessions; right panel is the active conversation. Features:

• Streaming responses, tool-call expansion, plan progress tracker
• Agent selector dropdown
• Channel selector (which channel this session belongs to)
• Attach files (uploads to Documents)
• Voice mode toggle
• Session search
• Fork / archive / delete per session

Agents

List view with one row per agent: name, description, default model, last activity. Click to edit:

• SOUL.md editor (with preview)
• Tool allowlist (per-skill toggles)
• Model preferences (primary + fallback)
• Heartbeat enable / interval
• AGENTS.md routing rules

Workflows

List + visual builder. Builder has a node palette, canvas, and inspector pane. See Workflows.

Skills

Grid view of installed skills with enable/disable per agent. Marketplace tab browses the Sophon Marketplace (separate service). Self-authored tab shows skills the agent has generated. See Skills.

Memory

Four tabs:

• Entries — paginated list, filters, add/edit/delete
• Logs — daily activity log
• Search — hybrid keyword + semantic
• Graph — interactive entity graph

See Memory.

Documents

Library grid with thumbnails. Click a doc to open detail view (extracted text, Q&A pane, metadata). Batch button for multi-doc operations. See Documents.

Tasks

Active and History tabs. Live updates. See Tasks.

Canvas

Splitscreen chat + editor. Usually opens automatically when the agent generates a code artifact, but accessible directly at /canvas?session=<id>. See Canvas.

Claude Code

Session list. Click to open a session with chat on the left and project tree + file editor on the right. See Claude Code Sessions.

Discussions

Active shows running discussions with live turn updates. Runs is the history. See Discussion (Preview).

Voice

Full-screen voice surface with the animated orb (same one used in the mobile app). Hands-free mode toggles via the Dashboard mic button or a system-wide keyboard shortcut (Electron only).

Approvals

Queue of pending approvals. Each card shows tool, risk, params, preview, countdown. Approve / Edit / Reject. See Approval Gates.

Admin

• Users — create / delete / role assignment
• Roles — built-in + custom roles with granular permission matrix
• Audit — immutable action log, filterable, exportable
• License — paste license key, view tier, features, expiry
• Compliance — report generation, retention policies, export
• Tenants (Enterprise) — manage tenant workspaces

See Enterprise.

Operations

• System — health metrics, service status, resource usage
• Control — pause/resume agent processing, clear caches, diagnostics
• Remote Access — onboarding tickets for remote-device enrollment

Settings

17 pages under Settings:

• Overview — installation info, tier, quick stats
• Account — profile, preferences, data export
• Appearance — theme, accent, layout
• Models — LLM provider management
• Connections — OAuth + API-key services (Connections)
• Webhooks — inbound + outbound (Webhooks)
• MCP — client connections + server hosting (MCP)
• Cron Jobs — scheduled tasks (Cron)
• Devices — Sophon Node pairings (Node)
• Voice — TTS provider + voice selection (Voice)
• Notifications — push categories + quiet hours
• Terminal — in-browser CLI terminal (Pro/Enterprise)
• Tools — global tool registry view (admin)
• Security — sessions, password, 2FA
• Activity — login + API-key usage log
• Backup — export chats, docs, memory, workflows
• Approved Senders — email allowlist

Routing

The Dashboard uses React Router. URLs are stable — you can bookmark any page. Session URLs like /chat/<session-id> are shareable within your team (other users see the same session only if they have access).

Keyboard shortcuts

Theming

Settings → Appearance. Choose:

• Dark / Light / System
• Accent color (6 presets + custom hex)
• Font size (compact / default / large)
• Layout density (cozy / compact)

Changes apply immediately without reload.

Real-time updates

Every live element — task status, chat streaming, approvals, notifications — comes through SignalR. If you see a "Reconnecting…" banner at the top, your SignalR connection dropped; the Dashboard reconnects with exponential backoff. Page reloads work if that ever gets stuck.

Where to go next

• Desktop App — Electron wrapper with tray and native keyboard shortcuts
• Mobile App — Sophon on iOS / Android
• CLI — scripted / headless access