Skip to content
Back

Publish popoverPro

Publish in a document toolbar opens a popover that slides out of the button: page address, who can open it, a host with its official mark and two switches; publishing walks through upload, build and live, then shows the link with Copy, views and Unpublish.

oxyn add publish-popover
Launch planQuillworks · edited 4 min ago
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

  • Publish an agent-written document to the web from where it is edited, with the address, access and host decided in one small popover.

When not to use

  • An app sidebar: use Sidebar instead.
  • A workspace sidebar: use Workspace sidebar instead.
  • A resizable sidebar that snaps to a 64 px icon rail, with a keyboard splitter and a breadcrumb that follows the page: use Sidebar rail instead.

Installation

Publish popover 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 publish-popover

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

Form

The popover open on the form.

Launch planQuillworks · edited 4 min ago
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

Taken

The address is taken; offers a free one.

Launch planQuillworks · edited 4 min ago
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

Closed

Just the toolbar button (Oxyn extra).

Launch planQuillworks · edited 4 min ago
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

PublishPopover

PropTypeDefaultDescription
nowrequiredClockMs—Host clock.
openbooltrueStart open.
takenboolDefault::default()The first address is taken (error scenario).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EnterPublish from the address field; copy the link when live
← → · HomeorEndPick who can open it or the host
EscapeClose the popover

Accessibility

  • The button reports the popover as an expanded dialog; the address field is labelled and flags a taken address.
  • Radio groups for access and host rove with the arrows; switches report on or off.
  • Publishing steps are announced; the busy area is marked busy.
From the spec

The button is aria-haspopup dialog with aria-expanded; the address input is labelled and aria-invalid when taken; access and host are roving radio groups; switches report on/off; Escape closes. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.

Motion & interaction

The popover slides out of its button (scale from the top right); publishing steps shimmer under a progress bar; the toolbar button turns into a Live dot.

Timing

Everything on screen is derived from the host clock now (no timers in the component), so playback, tests and the GPUI view agree.

TransitionDurationEasing
Slide in220 msovershoot
Upload900 ms—
Build1100 ms—
Go live600 ms—

Reduced motion: CSS motion is cut to a frame; decorative bands and rings are hidden or still; state and text changes stay.

Responsive behaviour

  • Under 520 px the popover narrows to 300 px and stays inside the card.
Edge cases (spec)

The popover is 340 px and narrows to 300 px under 520 px, staying inside the card; the address truncates its base. Host marks (Cloudflare, Vercel, Netlify) are official marks. 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 marks.

Notes for AI

  • Import PublishPopover from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: XPostView 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