Components
Live components
Every component in the Suprnova Live component library, running for real. Each preview is a Live island on this server: what you type goes to Rust and comes back as HTML, and the code beside it is the code that rendered it.
The previews run in frames. suprnova.app is a Vue 3.5 application built on the Pulsar starter kit, and a Live island needs a server-rendered page of its own, so each example is a separate Live page loaded in an iframe. An open list or popover therefore stays inside its frame; in a Live page of your own application it opens over the page.
Nothing you enter is kept. A preview binds to your own session on its first action, so no other visitor sees it. This site accepts no uploads: the upload and file input pages show those widgets without sending anything.
Installation
Components install into an application with the suprnova CLI, one directory each under templates/suprnova-ui/: the Askama macro view, the stylesheet, the script when the component has one, and the manifest that names them.
Opt a document into the token and base stylesheets with LiveBootstrapOptions::esm().with_suprnova_ui(), serve the vendored files with try_live_ui_assets(), and import the macros in your views. The Live chapter of the manual covers each step.
suprnova live:add field
suprnova live:add input
suprnova live:add buttonTheming
Every visual value is a --sn- custom property with light and dark values. Override the tokens on :root to retheme an application. The theme bar re-themes these previews the same way, and Copy theme gives you the block for your choice.
An application that already uses Tailwind CSS 4 can speak in the same tokens through the library's @theme preset:
@import "tailwindcss";
@import "./suprnova-ui.tailwind.css";Forms
- FieldA label, the control, a hint and the field's error output around one model field.
- LabelA label for a control you render yourself, with an optional required mark.
- InputA native text-like input bound to a model field.
- TextareaA multi-line text control bound to a model field.
- Number inputA native number input with bounds and a step.
- SliderA native range input that shows its value.
- Search inputA search input whose model updates are debounced by 250 ms.
- Password inputA password input with a reveal button; its model is transient, so it never enters a snapshot.
- CheckboxA single checkbox, and a group of checkboxes bound to a list.
- Radio groupA group of radio inputs, with a legend, bound to one value.
- SwitchA checkbox with the switch role.
- SelectA native select bound to one value.
- ButtonA native button with an explicit type and variant, and a link that reads as a button.
- Button groupA labeled group of related buttons.
- FieldsetA native fieldset with a legend, optionally disabled.
- Form actionsThe row of buttons that ends a form.
- Validation summaryThe form-level list of one action's validation errors.
- File inputA native file input; with `upload=true` it binds a Live upload field.
- UploadThe upload widget over the Live upload protocol, with a progress bar and a message for every state.
- Input OTPA one-time code as one native input, with presentation cells.
- Date pickerA native date input with year, month and day strips.
- ComboboxAn accessible combobox over a native input and list.
Overlays
- AccordionA group of native disclosures with shared or independent expansion.
- CollapsibleA native disclosure whose browser-owned open state survives compatible morphs.
- DialogA native modal dialog with a title, local triggers and focus return.
- DrawerA modal edge panel that opens from the logical start or end of the frame.
- Dropdown menuA single-level popover list of real links or registered server actions.
- PopoverA native non-modal popover for supplementary text or interactive content.
- SheetA native modal panel that rises from the bottom of the frame.
- TooltipA hover and focus description with Escape dismissal and no interactive bubble content.
Feedback
- AlertPersistent messages whose roles and severity cues match their urgency.
- Empty stateThe reason a region has nothing to show, with an available next action.
- Flash regionA region of outcome messages from an accepted request.
- Notification bellA notifications link with an accessible unread count and update status.
- ProgressNative determinate or indeterminate progress with a label and a text readout.
- SkeletonA layout placeholder revealed by the runtime while its bound action is loading.
- SpinnerA named activity indicator tied to the runtime's real loading state.
- ToastTransient server outcomes in a polite region with timed dismissal and a bounded queue.
Navigation
- Account menuA disclosure for one account identity, with route links and a sign-out action.
- BreadcrumbsAn ordered path of ancestor links and a non-linked current page.
- FooterA contentinfo landmark with route links and supporting text.
- Header barA brand link and primary navigation with the current destination marked by the server.
- Load moreA server action that appends keyed rows and disappears when the list is exhausted.
- PaginationCanonical page links or Live page actions with explicit boundary states.
- SidebarSection links grouped in native disclosures with browser-local collapse state.
- TabsLocal panels with keyboard selection or canonical route links in an explicit mode.
Data display
- Aspect imageAn image with a named aspect ratio that reserves its space before it loads.
- AvatarA named image or initials fallback, alone or in a labeled group.
- BadgeA compact status pill whose text carries the meaning alongside its color.
- CardAn article or section labeled by its own heading, with an optional actions row.
- ChartServer-rendered bar or line marks that follow the theme tokens, with a text and data alternative.
- DatatableA native keyed table with server sorting, search and pagination reflected into a shareable URL.
- Description listNative term-value pairs grouped in a labeled description list.
- List groupA labeled ordered or unordered list whose items keep stable domain keys.
- Live feedA keyed activity list with demo updates held in the visitor's own island.
- Scroll areaA labeled native scrolling region with keyboard focus and a visible focus ring.
- SeparatorA native thematic break or a labeled vertical rule without an extra wrapper.
- Stat cardA labeled statistic with a unit, timeframe and a trend direction expressed in text.
Shells
Blocks
- Sign-inServer validation of printed demo credentials, with no real sign-in.
- Data table page200 deterministic members with server-side search, sorting and pagination.
- Settings formProfile, notification and security settings validated on the server; nothing is saved.
- Activity panelStat cards, a feed and notifications, updated only in your island.
