Appearance
Component Index โ
Every component: what each one is called, whether it ships today, and where it is documented.
All of them ship. The status column is the honest part of this page, and npm run check:components keeps it that way โ a row marked stable has to name a class or hook that src/ actually defines, or the build fails. Nothing here is aspirational unless it says so. Those three numbers are checked against the table too: a count typed in prose above a verified table is the part a reader believes without counting, and it drifted the first time a component shipped.
This mattered: the page began life as a specification, so every row was written ๐ข because every row was intended, and it stayed that way while the implementation caught up. That is a docs page promising a hundred and forty stable components against a build that had about half of them โ and a docs page that lies about what ships is worse than a missing one, because the missing one is discovered before payment rather than after.
Status: ๐ข stable โ built, in the demo pages, covered by the test gate JS column: โ has a JS module ยท โ CSS only
Class names are this build's own (.av-*). Earlier revisions of this page used Bootstrap's names for components that had been renamed โ .btn, .form-control, .invalid-feedback โ which sent readers looking for classes that were never in the stylesheet.
Buttons & actions โ docs โ
| Component | Class | JS | Status |
|---|---|---|---|
| Button | .av-btn | โ | ๐ข |
| Soft button | .av-btn--soft-* | โ | ๐ข |
| Ghost button | .av-btn--ghost | โ | ๐ข |
| Quiet button | .av-btn--quiet | โ | ๐ข |
| On-media button | .av-btn--on-media | โ | ๐ข |
| Icon button | .av-btn--icon | โ | ๐ข |
| Loading button | [data-av-loading] | โ | ๐ข |
| Button group | .av-btn-group | โ | ๐ข |
| Split button | .av-btn-group + .av-dropdown | โ | ๐ข |
| Segmented control | .av-segmented | โ | ๐ข |
| Toggle button | .av-btn-toggle + aria-pressed | โ | ๐ข |
| Floating action button | .av-fab, .av-fab__label | โ | ๐ข |
| Copy button | [data-av-clipboard] | โ | ๐ข |
| Action menu | .av-dropdown | โ | ๐ข |
| Action row | .av-actions | โ | ๐ข |
Forms & inputs โ docs โ
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Text input | .av-input | โ | ๐ข |
| Save bar (unsaved changes) | .av-save-bar, [data-av-save-bar], [data-av-dirty-guard] | โ | ๐ข |
| Textarea (auto-grow) | [data-av-autosize] | โ | ๐ข |
| Select | .av-select | โ | ๐ข |
| Enhanced select | [data-av-select] | โ | ๐ข |
| Multi-select / tags | [data-av-select][multiple] | โ | ๐ข |
| Floating label | .av-float-label | โ | ๐ข |
| Input group | .av-input-group | โ | ๐ข |
| Field wrapper | .av-field | โ | ๐ข |
| Help text | .av-field__hint | โ | ๐ข |
| Validation feedback | .av-field__error | โ | ๐ข |
| Checkbox / radio | .av-check, .av-form-check | โ | ๐ข |
| Checkbox card | .av-choice | โ | ๐ข |
| Radio card | .av-choice | โ | ๐ข |
| Switch | .av-switch | โ | ๐ข |
| Range slider | [data-av-slider], .av-range | โ | ๐ข |
| Date picker | [data-av-datepicker] (native input[type=date]) | โ | ๐ข |
| Date range | [data-av-datepicker][data-av-mode="range"], .av-daterange | โ | ๐ข |
| Time picker | [data-av-timepicker] (native input[type=time]) | โ | ๐ข |
| Colour picker | [data-av-colorpicker], .av-color | โ | ๐ข |
| File input | .av-input[type=file] | โ | ๐ข |
| File dropzone | [data-av-uploader] | โ | ๐ข |
| Input mask | [data-av-mask] | โ | ๐ข |
| OTP input | [data-av-otp] | โ | ๐ข |
| Password strength | [data-av-password-strength] | โ | ๐ข |
| Password reveal | [data-av-password-toggle] | โ | ๐ข |
| Rating | [data-av-rating] | โ | ๐ข |
| Search field | .av-toolbar__search | โ | ๐ข |
| Rich text editor | [data-av-editor], .av-editor | โ | ๐ข |
| Code editor | [data-av-code-editor], .av-code-editor | โ | ๐ข |
| Form wizard | [data-av-wizard] | โ | ๐ข |
| Repeater / dynamic rows | [data-av-repeater], .av-repeater | โ | ๐ข |
| Line-item builder | [data-av-invoice-builder], .av-repeater__row--line-item | โ | ๐ข |
| Form validation | [data-av-validate] | โ | ๐ข |
Tables & grids โ docs โ
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Base table | .av-table | โ | ๐ข |
| Striped / bordered / hover | .av-table--striped, --bordered, --hover | โ | ๐ข |
| Sticky header | .av-table--sticky-head | โ | ๐ข |
| Sticky first column | .av-table--sticky-col | โ | ๐ข |
| Responsive card table | .av-table--cards + data-av-label | โ | ๐ข |
| Data grid | [data-av-datagrid] | โ | ๐ข |
| Advanced grid | [data-av-datagrid][data-av-datagrid-library=tabulator] | โ | ๐ข |
| Grid filter builder | [data-av-grid-filters] + .av-filter-row | โ | ๐ข |
| Saved views | [data-av-grid-views] + .av-view-chip | โ | ๐ข |
| Grid CSV export | [data-av-grid-export] | โ | ๐ข |
| CSV import wizard | [data-av-import] | โ | ๐ข |
| Keyboard shortcuts | [data-av-shortcut] | โ | ๐ข |
| Chord hint | .av-chord-hint | โ | ๐ข |
| Column mapping row | .av-map-row | โ | ๐ข |
| Bulk selection | [data-av-grid-select-all] | โ | ๐ข |
| Bulk on/off | [data-av-grid-bulk-switch] + [data-av-grid-row-switch] | โ | ๐ข |
| Expandable rows | [data-av-row-expand], .av-table__detail | โ | ๐ข |
| Inline edit | [data-av-inline-edit], .av-inline-edit | โ | ๐ข |
| Column chooser | [data-av-columns], .av-columns__item | โ | ๐ข |
| Virtual scroll | [data-av-virtual], .av-virtual__spacer | โ | ๐ข |
| Tree table | [data-av-tree-table], .av-table--tree | โ | ๐ข |
| Empty / loading / error states | [data-av-grid-empty], [data-av-grid-none], [data-av-grid-clear] | โ | ๐ข |
Cards & surfaces โ docs โ
| Component | Class | JS | Status |
|---|---|---|---|
| Section | .av-section, .av-section__action | โ | ๐ข |
| Card | .av-card | โ | ๐ข |
| Card header / body / footer | .av-card__* | โ | ๐ข |
| Stat card | .av-stat-card | โ | ๐ข |
| Role card | .av-role-card, .av-role-grid | โ | ๐ข |
| Stat card, vivid and hero | .av-stat-card--vivid, .av-stat-card--hero | โ | ๐ข |
| Hero band | .av-hero-band | โ | ๐ข |
| Stat card โ role | .av-stat-card--success, --warning, --info, --danger | โ | ๐ข |
| KPI card | .av-kpi, .av-kpi__bar | โ | ๐ข |
| Media card | .av-card--media, .av-card__media | โ | ๐ข |
| Hero band card | .av-card--hero | โ | ๐ข |
| Profile card | .av-customer-card, .av-customer-card__tags | โ | ๐ข |
| Pricing card | .av-pricing-card, --featured | โ | ๐ข |
| Glass panel | .av-glass | โ | ๐ข |
| Gradient-border card | .av-border-gradient | โ | ๐ข |
| Spotlight card | .av-spotlight | โ | ๐ข |
| Panel | .av-panel, --flush | โ | ๐ข |
Navigation โ docs โ
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Tabs (line) | .av-tabs--line | โ | ๐ข |
| Tabs (pill) | .av-tabs--pill | โ | ๐ข |
| Tabs (enclosed) | .av-tabs--enclosed | โ | ๐ข |
| Vertical tabs | .av-tabs--vertical | โ | ๐ข |
| Steps / stepper | .av-steps | โ | ๐ข |
| Breadcrumb | .av-breadcrumb | โ | ๐ข |
| Pagination | .av-pagination, .av-pagination--simple, .av-pagination--compact | โ | ๐ข |
| Anchor nav / scrollspy | [data-av-scrollspy] | โ | ๐ข |
| Public page shell | .av-public, .av-public__bar, .av-public__main | โ | ๐ข |
| Tree view | .av-tree | โ | ๐ข |
| Command palette | [data-av-palette] | โ | ๐ข |
| Disclosure | [data-av-collapse] + .av-disclosure__panel | โ | ๐ข |
| Jump links | .av-jump, .av-jump--sticky | โ | ๐ข |
| Back to top | .av-back-to-top + [data-av-back-to-top] | โ | ๐ข |
| Nav bar (horizontal menu) | [data-av-layout="horizontal"] + .av-menu__group-list | โ | ๐ข |
| Nav layout preview | .av-nav-preview | โ | ๐ข |
Feedback & overlays โ docs โ
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Alert | .av-alert | โ | ๐ข |
| Soft alert | .av-alert--*-soft | โ | ๐ข |
| Banner | .av-banner, [data-av-banner-dismiss] | โ | ๐ข |
| Toast | [data-av-toast] | โ | ๐ข |
| Confirm dialog | [data-av-confirm] | โ | ๐ข |
| Modal | .av-dialog, [data-av-modal-open], [data-av-modal-close] | โ | ๐ข |
| Drawer / offcanvas | .av-drawer, [data-av-drawer-open] | โ | ๐ข |
| Bottom sheet | .av-sheet | โ | ๐ข |
| Popover | [data-av-popover], .av-popover | โ | ๐ข |
| Tour | [data-av-tour-start] + [data-av-tour], .av-tour | โ | ๐ข |
| Tooltip | [data-av-tooltip] | โ | ๐ข |
| Context menu | [data-av-context-menu], .av-context-menu | โ | ๐ข |
| Lightbox | [data-av-lightbox], .av-lightbox | โ | ๐ข |
| Progress bar | .av-progress | โ | ๐ข |
| Circular progress | .av-progress-ring | โ | ๐ข |
| Spinner | .av-spinner, --sm, --lg | โ | ๐ข |
| Skeleton | .av-skeleton | โ | ๐ข |
| Empty state | .av-empty | โ | ๐ข |
| Error state | .av-error | โ | ๐ข |
Data display โ docs โ
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Avatar | .av-avatar | โ | ๐ข |
| Avatar group | .av-avatar-group | โ | ๐ข |
| Avatar with status | .av-avatar--status | โ | ๐ข |
| Avatar upload and crop | [data-av-avatar-upload] | โ | ๐ข |
| Badge | .av-badge | โ | ๐ข |
| Soft badge | .av-badge--*-soft | โ | ๐ข |
| Solid badge | .av-badge--* | โ | ๐ข |
| Dot badge | .av-dot + role modifiers | โ | ๐ข |
| Chip / tag | .av-chip | โ | ๐ข |
| Media thumbnail | .av-thumb, --av-thumb-size | โ | ๐ข |
| FAQ accordion | .av-faq, .av-faq__q, .av-faq__a | โ | ๐ข |
| Status dot | .av-status-dot, --online, --away, --busy, --offline | โ | ๐ข |
| Timeline | .av-timeline | โ | ๐ข |
| Gantt | .av-gantt | โ | ๐ข |
| Activity feed | .av-activity | โ | ๐ข |
| Audit log | .av-log, .av-log__date, .av-log__mark--* | โ | ๐ข |
| Description list | .av-detail-list | โ | ๐ข |
| Stat trend | .av-trend | โ | ๐ข |
| Sparkline | [data-av-chart] + "sparkline": true | โ | ๐ข |
| Count-up | [data-av-countup] | โ | ๐ข |
| Code block | .av-code | โ | ๐ข |
| One-time code list | .av-code-list | โ | ๐ข |
| Keyboard key | .av-kbd | โ | ๐ข |
| Person cell | .av-table__person | โ | ๐ข |
| Progress list | .av-channel | โ | ๐ข |
| Prose block | .av-prose | โ | ๐ข |
| Identifier | .av-ident, --sm | โ | ๐ข |
Charts โ docs โ
| Type | Hook | Status |
|---|---|---|
| Line / area / bar / column | [data-av-chart] "type" | ๐ข |
| Donut / pie / radial | [data-av-chart] "type" | ๐ข |
| Sparkline | [data-av-chart] "sparkline" | ๐ข |
| Heatmap | [data-av-chart] "type" | ๐ข |
| Candlestick | [data-av-chart] "type" | ๐ข |
| Radar | [data-av-chart] "type" | ๐ข |
| Treemap | [data-av-chart] "type": "treemap" | ๐ข |
| Mixed / combo | [data-av-chart] "mixed" + per-series "type" | ๐ข |
| Funnel | [data-av-chart] "funnel" | ๐ข |
Application components โ
| Component | Hook | Status |
|---|---|---|
| Calendar | [data-av-calendar] | ๐ข |
| Kanban board | [data-av-kanban] | ๐ข |
| File manager | .av-files | ๐ข |
| Chat | .av-chat | ๐ข |
| Prompt composer | .av-prompt + [data-av-prompt] | ๐ข |
| Mail list | .av-mail-list | ๐ข |
| Map | [data-av-map], .av-map | ๐ข |
| Carousel | [data-av-carousel], .av-carousel | ๐ข |
| Sortable list | [data-av-sortable], .av-sortable | ๐ข |
Utilities โ
| Utility | Class | Status |
|---|---|---|
| Glass | .av-glass, --strong, --subtle | ๐ข |
| Gradient text | .av-text-gradient | ๐ข |
| Gradient border | .av-border-gradient | ๐ข |
| Glow | .av-glow, --success, --warning, --danger, --info | ๐ข |
| Grain overlay | .av-grain | ๐ข |
| Lift on hover | .av-lift, --sm | ๐ข |
| Truncate | .av-truncate, -2, -3 | ๐ข |
| Stack / cluster / switcher / grid | .av-stack-4 | ๐ข |
| Scroll reveal | [data-av-reveal] | ๐ข |
| Aspect ratio | .av-ratio, --1x1, --4x3, --21x9 | ๐ข |
| Visually hidden | .av-visually-hidden | ๐ข |
Conventions every component follows โ
1. Tier-3 tokens at the top โ
scss
.av-card {
--av-card-padding: var(--av-space-5);
/* โฆ every value a caller might reasonably need to change */
}Override contextually without specificity battles:
html
<div class="av-card" style="--av-card-padding: var(--av-space-2)">2. States โ
| Mechanism | Use |
|---|---|
.is-* | Transient, JS-controlled: is-loading, is-open, is-selected |
.has-* | Structural, author-declared: has-icon, has-footer |
data-av-state | Enumerated: idle / loading / empty / error |
| ARIA | Always paired with the visual state |
3. Every component documents all five states โ
Default ยท hover/focus ยท active/selected ยท disabled ยท loading โ plus empty and error where applicable.
4. Every interactive component documents its keyboard model โ
If it can be clicked, it can be operated from the keyboard, and the docs say exactly how.
Choosing between similar components โ
| Need | Use |
|---|---|
| Show a status | .av-badge--*-soft (has icon + text) |
| Show a removable value | .av-chip |
| Show online/offline | .av-status-dot |
| Show a count | .badge inside the labelled element |
| Confirm a destructive action | [data-av-confirm] |
| Show a transient result | AdminVora.toast |
| Show a persistent system message | .av-banner |
| Show an inline validation error | .invalid-feedback |
| Simple list, โค 50 rows, no sorting | .av-table |
| Sorting, search, pagination | [data-av-datagrid] |
| Grouping, tree data, export | [data-av-datagrid][data-library=tabulator] |
| 10,000+ rows | [data-av-virtual] |
| Choose one of 2โ5 options | .av-segmented |
| Choose one of 5โ15 options | .form-select |
| Choose one of 15+ options | [data-av-select] with search |
| Choose several | [data-av-select][multiple] |
Animated icons โ docs โ
Motion primitives, not icons: the classes name what moves, so forty icons share about a dozen keyframes and a new icon usually needs no new CSS. CSS-only โ no Lottie player, no JSON payload.
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Animated icon | .av-aicon + .av-aicon--<name> | โ | ๐ข |
| Motion primitive | .av-aicon__<motion> | โ | ๐ข |
| Draw-on path | .av-aicon__draw + pathLength="100" | โ | ๐ข |
| Staggered dots | .av-aicon__dot-2 .av-aicon__dot-3 | โ | ๐ข |
| Size modifiers | .av-aicon--sm .av-aicon--md .av-aicon--lg .av-aicon--xl | โ | ๐ข |
| Role colours | .av-aicon--success .av-aicon--warning .av-aicon--danger .av-aicon--info | โ | ๐ข |
| Always-on loop | .av-aicon--loop | โ | ๐ข |
| Gallery tile | .av-aicon-tile | โ | ๐ข |
| Play-all toggle | [data-av-aicon-playall] | โ | ๐ข |
Account, access & storefront โ docs โ
The screens a product needs before it needs a tenth dashboard: plans, billing, security, keys, members, roles, integrations โ and a customer-facing storefront built from the same components as the admin, rather than from a second design system.
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Onboarding checklist | .av-checklist | โ | ๐ข |
| Checklist meter | .av-checklist-meter | โ | ๐ข |
| Profile hero | .av-profile-hero | โ | ๐ข |
| Profile stat strip | .av-profile-stats | โ | ๐ข |
| Tab-shaped navigation | .av-tab-nav | โ | ๐ข |
| Section sub-navigation | .av-subnav | โ | ๐ข |
| Permission matrix | .av-matrix + [data-av-matrix] | โ | ๐ข |
| Secret field | .av-secret + [data-av-secret] | โ | ๐ข |
| Integration card | .av-integration | โ | ๐ข |
| Integration grid | .av-integration-grid | โ | ๐ข |
| Usage meter list | .av-usage | โ | ๐ข |
| Topbar vitals strip | .av-vitals | โ | ๐ข |
| Player bar | .av-player | โ | ๐ข |
| Plan grid | .av-plan-grid | โ | ๐ข |
| Plan comparison table | .av-plan-table | โ | ๐ข |
| Billing cycle switch | [data-av-plans] | โ | ๐ข |
| Faceted filter panel | .av-facets + [data-av-facets] | โ | ๐ข |
| Results toolbar | .av-results-bar | โ | ๐ข |
| Facet chip | .av-facet-chip | โ | ๐ข |
| Grid / list view toggle | [data-av-view-toggle] | โ | ๐ข |
| Product card | .av-product-card | โ | ๐ข |
| Product grid | .av-product-grid | โ | ๐ข |
| Product list view | .av-product-grid--list | โ | ๐ข |
| Brand tile | .av-tile | โ | ๐ข |
| Buy box | .av-buy | โ | ๐ข |
| Quantity stepper module | [data-av-qty] โ styled by the basket's .av-qty | โ | ๐ข |
| Promo tile | .av-promo | โ | ๐ข |
| Storefront hero | .av-store-hero | โ | ๐ข |
| Wishlist toggle | [data-av-favourite] | โ | ๐ข |
| Cell subtext | .av-table__sub | โ | ๐ข |
| Row actions cell | .av-table__actions | โ | ๐ข |
MCP connectors: docs โ
The pieces the MCP connector pages are built from, none of them specific to MCP: a list of things that each carry a three-state permission, a header control that sets a whole group of them, a line-by-line diff, and a search-and-chips filter for lists that are not tables.
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Policy list | .av-policy | โ | ๐ข |
| Policy group header | .av-policy-head | โ | ๐ข |
| Group control (cascade) | [data-av-cascade] + [data-av-cascade-parent] | โ | ๐ข |
| Diff | .av-diff | โ | ๐ข |
| List filter | [data-av-list-filter] | โ | ๐ข |
| Integration meta line | .av-integration__meta | โ | ๐ข |
Overlays & panels โ docs โ
The topbar opens two drawers rather than two dropdowns. A dropdown is the right shape for a short list of commands; a notification feed with inline actions and a footer, or a conversation with a composer, is a panel โ and at that size a menu anchored to a 32px button fights its own geometry. Both reuse .av-drawer, so the open and close animation, Escape, the backdrop click and the focus trap are the component that already has them.
| Component | Class / hook | JS | Status |
|---|---|---|---|
| Basket drawer | .av-cart-drawer + [data-av-cart] | โ | ๐ข |
| Notification feed | .av-feed | โ | ๐ข |
| Feed row | .av-feed__item + .is-unread | โ | ๐ข |
| Feed inline card | .av-feed__card | โ | ๐ข |
| Feed filter tabs | [data-av-notif-filter] | โ | ๐ข |
| Messages drawer | .av-msg-drawer + [data-av-msgs] | โ | ๐ข |
| Conversation rail | .av-msg-drawer__rail + .av-msg-drawer__conv | โ | ๐ข |
| Thread header | .av-msg-drawer__peer | โ | ๐ข |
| Message read receipt | .av-message__receipt | โ | ๐ข |
| Join request row | .av-msg-drawer__request | โ | ๐ข |
| Message composer | .av-msg-drawer__field + [data-av-msgs-send] | โ | ๐ข |
| Quick replies | [data-av-msgs-quick] | โ | ๐ข |
| Wide drawer | .av-drawer--wide | โ | ๐ข |
| Event composer | .av-event-form + [data-av-event-allday] | โ | ๐ข |
Adding a component โ
There is no generator, so a component is four hand edits:
src/scss/components/_pricing-table.scss, with every rule inside@layer components.@use 'components/pricing-table';insrc/scss/adminvora.scss. The layer order is declared once in_layers.scss, so this line registers the partial rather than placing it in the cascade.- Behaviour, if the component needs any, behind a
data-av-*hook insrc/js/adminvora.js.npm run check:hooksfails on a hook nothing reads. - A row in this index and a fragment in
html/_qa/components.html.npm run check:componentsfails on a row whose selector is not insrc/.
To browse every component live, see Component Reference Pages.
Read next: Buttons & Actions.