Cube mascotPro
An isometric cube with three shaded sides and a painted face: it tilts and blinks at rest, turns a quarter at a time while thinking with the face moving to the side in front, prints lines on the floor while writing, and sparkles when done.
oxyn add cube-mascotThe 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
- A geometric assistant for technical products: an isometric cube with a face painted on its front side.
When not to use
- Replays a multi-agent run on one clock: use Agent timeline instead.
- One model at a glance: use Model card instead.
- A small automation on a single rail: use AI workflow instead.
Installation
Cube mascot 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 cube-mascotUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Loop
Plays every status in turn.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Thinking ink
Thinking, ink (Oxyn extra).
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Sizes
Writing with a size ladder (Oxyn extra).
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
CubeMascot
| Prop | Type | Default | Description |
|---|---|---|---|
nowrequired | ClockMs | — | Host clock. |
status | String | Default::default() | Status; empty plays the loop. |
size | f32 | 96.0 | Size, px. |
tone | String | "violet" | `ink`, `soft` or `violet`. |
ground | bool | true | The contact shadow and printed lines. |
paused | bool | Default::default() | Freeze. |
name | String | "Assistant" | Name in the label. |
announce | bool | Default::default() | Announce status changes. |
picker | bool | Default::default() | Status chips and Pause (Oxyn extra). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| — | A status image: it takes no focus. |
Accessibility
- The drawing is role img labelled with the name and status (Atlas, writing).
- With announce on, status changes are read in a polite live region outside the image; use it on one character per view.
- Each status also changes the expression (eyes widen, lift, drop, squint with joy, brows knit), so meaning never rests on movement or colour.
- Reduced motion keeps each status's face and drops the loops.
From the spec
role img labelled with name and status; optional polite announcements. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.
Motion & interaction
Eight real 3D corners are turned and projected each frame; the three visible sides are sorted by depth and shaded top, front and side; the face is mapped onto its side.
Timing
Everything on screen is derived from the host clock now (no timers in the component), so playback, tests and the GPUI view agree.
| Transition | Duration | Easing |
|---|---|---|
| Status blend | 420 ms (BLEND_MS) | ease-in-out |
| Loop step | 2800 ms per status (STEP_MS) | — |
| Blink | 140 ms every 3.6 s | linear |
| Error shake | 700 ms, decaying | sine |
| Quarter turn | hold 0.5 s, turn 0.8 s | ease-in-out |
Reduced motion: loops and travel stop; each state shows its end pose and its words.
Responsive behaviour
- A fixed square; the sides are real 3D corners projected each frame.
- Under 56 px the cube is framed tighter with larger eyes.
Edge cases (spec)
A fixed square; under 56 px a tighter framing. Tones: violet, ink, soft. Checked at 1440, 768 and 390 px in light and dark with no text overlap. Chrome is monochrome grey; colour is semantic only (success, warning, danger, info) plus the official coloured brand and model marks.
Notes for AI
- Import
CubeMascotfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
AiKitViewinoxyn_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.