Skip to content

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 โ€‹

ComponentClassJSStatus
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 โ€‹

ComponentClass / hookJSStatus
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 โ€‹

ComponentClass / hookJSStatus
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 โ€‹

ComponentClassJSStatus
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โ—‹๐ŸŸข
ComponentClass / hookJSStatus
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 โ€‹

ComponentClass / hookJSStatus
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 โ€‹

ComponentClass / hookJSStatus
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 โ€‹

TypeHookStatus
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 โ€‹

ComponentHookStatus
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 โ€‹

UtilityClassStatus
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 โ€‹

MechanismUse
.is-*Transient, JS-controlled: is-loading, is-open, is-selected
.has-*Structural, author-declared: has-icon, has-footer
data-av-stateEnumerated: idle / loading / empty / error
ARIAAlways 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 โ€‹

NeedUse
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 resultAdminVora.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.

ComponentClass / hookJSStatus
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.

ComponentClass / hookJSStatus
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.

ComponentClass / hookJSStatus
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.

ComponentClass / hookJSStatus
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:

  1. src/scss/components/_pricing-table.scss, with every rule inside @layer components.
  2. @use 'components/pricing-table'; in src/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.
  3. Behaviour, if the component needs any, behind a data-av-* hook in src/js/adminvora.js. npm run check:hooks fails on a hook nothing reads.
  4. A row in this index and a fragment in html/_qa/components.html. npm run check:components fails on a row whose selector is not in src/.

To browse every component live, see Component Reference Pages.

Read next: Buttons & Actions.

Documentation for @creativeigniter/adminvora