User Guide
The app, in one tour
Two surfaces do most of the work: the sidebar on the left for navigation, and the top bar for controls that follow you between pages.
The sidebar
On desktop, the sidebar lives on the left. On mobile it slides in from the menu icon in the top bar. A toggle in the sidebar header collapses it to an icon strip when you want more room for chat.
Top of the sidebar
New Chat is the big rose button. It opens a persona picker.
Below it: Scenarios, Personas, Persona Directory.
Recent
Your last 20 chats, newest first. Hover a row for rename and delete.
More History at the bottom of the section opens the full History page.
Extensions section
Below Recent, extensions are grouped by what they do: My Toys for physical devices, My Utilities for sensors, capture, lighting, and ambience, and My Integrations for external services, prompt helpers, TTS, and webhooks. Marketplace is the catalogue. Dev Extensions only shows up if Developer Mode is on.
Small numeric badges count enabled extensions per category. A warning badge on the section header means at least one installed extension has an update available.
Footer
At the bottom of the sidebar: a usage meter when you're on the Built-In provider, then your account button. Click it for Profile, Settings, Upgrade Plan or Manage Billing, and Log Out. Admins also see an Admin entry in the nav above.
The top bar
Page label on the left, context controls on the right.
Page label
Each page has a small uppercase kicker (Conversation, Structured Play, Character Library, Configuration, and so on) with a larger title below. When a scenario is running in chat, the scenario name takes over and a message counter appears next to it so you can see how deep you are into the scene.
Right-hand controls
- Toy E-Stop. Sends an immediate stop to every supporting toy. Only renders in chat when a compatible extension is active and the option is on. The toggle lives in Settings → Advanced.
- Reload developer extension. Refreshes your local extension from disk. Only appears with Developer Mode on and a dev extension loaded.
- System alerts. A bell for anything the app needs to surface.
- Extension status icons. One per enabled extension instance. Green means connected, gray means not. Click for a quick-control dropdown.
Themes
Themes live in Settings → Appearance. Two are free: Velvet Tribute (the default) and Think Pink. Supporter unlocks six more. Supporter+ adds four premium themes — Obsidian Velvet, Honeyed Dusk, Cyber Bloom, and Sanguine Cathedral — along with the custom theme builder. The builder lets you tune colours and export the result as JSON.
On mobile
Below the tablet breakpoint, the sidebar collapses. Tap the menu icon in the top bar to slide it in as an overlay; tap a link to navigate, or tap outside to dismiss. The top bar controls stay put, including the Toy E-Stop.