Onboarding / BrandPro
Onboarding / Brand, step 2 of 4: the company's name plus the shorter names people use for it, a brand colour (eight swatches or a checked hex, with a warning when it would vanish on white or in dark mode) and a mark (initials, square, round or an uploaded logo). The preview glides to the assistant card in the new colour.
oxyn add onboarding-brandWhat's your company called?
Your assistant introduces itself with it. Pick a colour and a mark, too.
- Kestrel StudioCompany
- KestrelShort form
Colour
Mark
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.
Rendered from Rust at build time · goes live when visible
When to use
- Step 2 of 4: the company's name (how the assistant introduces itself), short forms it should also answer to, and the brand colour and mark the chat uses.
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
Onboarding / Brand 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.
oxyn add onboarding-brandUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Sample
Sample data, the dashboard preview as an inset panel.
What's your company called?
Your assistant introduces itself with it. Pick a colour and a mark, too.
- Kestrel StudioCompany
- KestrelShort form
Colour
Mark
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Flat
The same step with the preview edge to edge.
What's your company called?
Your assistant introduces itself with it. Pick a colour and a mark, too.
- Kestrel StudioCompany
- KestrelShort form
Colour
Mark
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Loading
Skeletons in the form and the preview.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Empty
A first visit: nothing filled in, Continue explains what is missing.
What's your company called?
Your assistant introduces itself with it. Pick a colour and a mark, too.
Add the name people know you by, then any short forms.
Colour
Mark
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Custom
A typed hex colour and an uploaded logo.
What's your company called?
Your assistant introduces itself with it. Pick a colour and a mark, too.
- Kestrel StudioCompany
- KestrelShort form
Colour
Mark
kestrel-mark.svg · 4 KB
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
X1
Oxyn: each step named under its dash; done steps can be revisited.
What's your company called?
Your assistant introduces itself with it. Pick a colour and a mark, too.
- Kestrel StudioCompany
- KestrelShort form
Colour
Mark
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
X2
Oxyn: the form alone, centred, without the preview.
What's your company called?
Your assistant introduces itself with it. Pick a colour and a mark, too.
- Kestrel StudioCompany
- KestrelShort form
Colour
Mark
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Enter | Add the name |
| Arrow keys | Move through swatches and marks |
| Tab | Remove, colours, hex, marks, Continue |
Accessibility
- The steps are an ordered list; the current one has aria-current=step and each is named “Step n of 4: …”.
- Fields have labels; a problem sets aria-invalid and shows its message as an alert beside the field.
- Colour, mark, tone and length are radiogroups; the handover is a switch.
- The preview is decorative (aria-hidden); everything it shows is also in the form. Every action reports in a polite live region.
Responsive behaviour
- Authored on the 1440 × 900 canvas: a 720 px form column and a 720 px preview.
- Under 960 px the preview leaves the page and opens over the form from Preview in the top bar.
- Under 620 px the signed-in address hides, marks go two by two and the summary tightens.
Edge cases (spec)
Authored on the 1440 × 900 stage (rule R1) and scaled to its column; the full view (/screens/onboarding-brand/full) renders at the real viewport with the state bar under it (R2). Under 960 px the preview leaves the page and opens over the form from Preview in the top bar (with Close). Under 620 px the signed-in address hides, marks go two by two and summary rows tighten. Labels ellipsise in flex children 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
OnboardingBrandScreenfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
OnboardingBrandElinoxyn_gpui. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.