Live visitorsPro
Who is on your site this second: a headcount whose digits roll, a dot map where each new visitor flashes, the busiest pages ranked with bars, and fresh sign-ups and upgrades listed with their country flag.
oxyn add live-visitors132 people on the site now
Top pages
- /50
- /pricing28
- /docs/quickstart27
- /blog/offline-sync25
Conversions
- Upgraded to TeamParis, FR1 min ago
- Started a Pro trialMilan, IT3 min ago
- Signed upStockholm, SE4 min ago
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
- Show a site's live audience at a glance: how many are on it, where they are, which pages they read and who converted.
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
Live visitors 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 live-visitorsUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Live
A simulated marketing site stream.
132 people on the site now
Top pages
- /50
- /pricing28
- /docs/quickstart27
- /blog/offline-sync25
Conversions
- Upgraded to TeamParis, FR1 min ago
- Started a Pro trialMilan, IT3 min ago
- Signed upStockholm, SE4 min ago
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Reconnecting
Reconnecting keeps the last data.
132 people on the site now
Top pages
- /50
- /pricing28
- /docs/quickstart27
- /blog/offline-sync25
Conversions
- Upgraded to TeamParis, FR1 min ago
- Started a Pro trialMilan, IT3 min ago
- Signed upStockholm, SE4 min ago
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Compact
No map, three pages (Oxyn extra).
132 people on the site now
Top pages
- /50
- /pricing28
- /docs/quickstart27
Conversions
- Upgraded to TeamParis, FR1 min ago
- Started a Pro trialMilan, IT3 min ago
- Signed upStockholm, SE4 min ago
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
LiveVisitors
| Prop | Type | Default | Description |
|---|---|---|---|
nowrequired | ClockMs | — | Host clock. |
connection | &'static str | "live" | `live`, `connecting` or `reconnecting`. |
paused | bool | Default::default() | Start paused. |
max_pages | usize | 4 | Pages listed. |
map | bool | true | Show the map. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Only the pause control is focusable; map and lists are display only |
| EnterorSpace | Pause or resume |
Accessibility
- The count is read once as plain text; the rolling digits are hidden from assistive tech.
- Pause reports whether it is on and its name says what pressing it does.
- Status is a dot next to Live, Paused or Reconnecting, never colour alone.
From the spec
The count is read once as text and the rolling digits are hidden; Pause is a toggle with aria-pressed; status is a dot plus a word. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.
Motion & interaction
Digits roll on their own strips in tabular numerals; arrivals ping on a dotted map and fade over eight ticks, conversions ring stronger; page bars resize and reorder; conversions slide in with a flag.
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 |
|---|---|---|
| Stream tick | 1600 ms | — |
| Digit roll | 280 ms | ease-out |
| Ping ring | 900 ms | ease-out |
Reduced motion: loops and travel stop; each state shows its end pose and its words.
Responsive behaviour
- Caps at 640 px; on narrow cards the two lists sit one above the other and the map shrinks to fit.
- Paths and cities end in an ellipsis; counts keep right-aligned tabular columns.
Edge cases (spec)
At most 640 px; under 520 px (container query) the lists stack; the map keeps its ratio. Paths and cities end in an ellipsis; counts keep fixed columns. 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
LiveVisitorsfromoxyn_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.