Skip to content
Back

AI Chat / StartPro

A greeting over the composer – Add, ask-before-acting, model and voice – with a folder and apps to work in and starters that fill the prompt; sending opens a new chat.

oxyn add chat-start

Good evening, Rowan. What are we working on?

The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • Where a new chat begins: a greeting over the exact composer, a folder and apps to work with, and suggestions that fill the prompt.

When not to use

  • Mail folders with counts and labels beside a message list: use Inbox sidebar instead.
  • The app frame: use App shell instead.
  • An assistant docked beside a page: use AI side panel instead.

Installation

AI Chat / Start is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add chat-start

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Sample

Sample data in the Inset frame.

Good evening, Rowan. What are we working on?

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Flat

The same screen in the Flat frame.

Good evening, Rowan. What are we working on?

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Loading

Skeletons where the data will land.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Empty

Nothing yet: each region says what will appear.

Good evening, Rowan. What are we working on?

Your first chat will show up in the sidebar.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Attached

Files, a sheet and an app page attached in the composer.

Good evening, Rowan. What are we working on?

brief.pdfbudget-by-team.csvNotion page
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Dictating

The composer taking dictation: a live waveform in place of the field.

Good evening, Rowan. What are we working on?

Listening… speak, then press the mic to stop
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

ChatStartScreen

PropTypeDefaultDescription
layoutString"inset"`inset` or `flat`.
stateString"sample"`sample`, `loading`, `empty`, `attached` or `dictating`.
heightu32640Height px.
houru3219Hour of day for the greeting (0–23).
nowrequiredClockMs—The clock.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabSidebar, page, then the work area
←or→ on a hairlineResize the sidebar or work area
EscapeClose an open menu; clear search
EnterSend (Shift+Enter: new line)

Accessibility

  • The sidebar is a labelled nav; the open chat has aria-current and unread chats say so.
  • Menus open from a trigger that reports aria-expanded; their items are menuitemradio and Escape shuts them.
  • Hairlines are separators with a value and arrow keys; skeletons are hidden from screen readers.

Responsive behaviour

  • Under 860 px of width the work area becomes a sheet opened from the top bar.
  • Under 640 px the sidebar slides in from the menu button and the composer drops its labels.
Edge cases (spec)

Every screen is authored on the 1440 × 900 stage (rule R1) and scaled to its column; the full view (/screens/<slug>/full) renders at the real viewport with the state bar under it (R2). Under 860 px of real width the work area becomes a sheet opened from the top bar; under 640 px the sidebar slides in from a menu button and the composer's approval and model chips drop their labels (icons stay). Every label in a row, chip or card title ellipsises in a flex child with min-width 0 (R5); scripts/ovl.py finds no text overlap at 1440, 768 and 390 in light and dark.

Notes for AI

  • Import ChatStartScreen from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: ChatStartEl in oxyn_gpui.
  • Props to set first: now.
  • It reads a clock (now) for live timers; pass one clock for the whole page rather than one per component.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI