Skip to content

Components

Primitives use the Gk prefix. Each page documents props, events, slots, and examples. Form controls live under /components/form in the docs and under src/vue/components/form/ in the package.

Quick add

bash
npx god-kit@latest add button

Compatibility alias: npx add gk button.

The CLI targets Vue Vite and Nuxt projects, supports --yes, --dry-run, --cwd, and --force, and ships a registry key for each public Gk* component (run npx god-kit --help for the full list; source cli/manifests/components.json in the repo).

Integration recipes

Form

ComponentDescription
GkFormNative <form> with validation slot helpers and createForm
GkInputText-like input with v-model and field integration
GkFieldLabel, control slot, and error region for forms
GkTextareaMultiline text with GkField integration
GkCheckboxBoolean checkbox with v-model
GkRadioGroup & GkRadioRadio group with shared name and v-model
GkSelectNative <select> with options array
ComponentDescription
GkTabsTab list + panels — v-model, items or GkTab + #window, GK_TABS injection
GkPaginationPage navigation — ellipsis, totalVisible, first/last, buildPaginationRange

Data

ComponentDescription
GkDataTableSortable table — client / server modes, selection, expand, grouping, god-kit/vue/data

Containment

Overlays, modal shells, and other primitives that contain focus and layer above the page.

ComponentDescription
GkOverlayTeleported overlay with scrim, v-model, Escape / scrim dismiss, body scroll lock, and tokenized stacking
GkDialogDialog shell built on GkOverlayfullscreen, scrollable, sizing props, afterEnter / afterLeave
GkBottomSheetBottom-anchored sheet on GkOverlayinset, scrollable, slide-up transition
GkMenuFloating menu — activator slot, placement, useMenuAnchorPosition, outside dismiss
GkTooltipTooltip — hover / focus / click, interactive, useTooltipPosition
GkNavigationDrawerSide / bottom nav — temporary scrim, rail, location, slots

Expansion

ComponentDescription
GkExpansionPanelsAccordion container with v-model (open keys), multiple, disabled
(children)GkExpansionPanel, GkExpansionPanelTitle, GkExpansionPanelText — see the expansion page

Feedback & layout

ComponentDescription
GkButtonButton with primary, secondary, ghost, and danger variants
GkAlertInline status messages with variants
GkStackFlex row/column layout with token gap
GkContainerCentered max-width container
GkDividerHorizontal or vertical separator
GkSpinnerLoading indicator with role="status"
GkSkeletonLoaderPreset skeleton layouts — type, shimmer / boilerplate, loading
GkSnackbarTransient messages — timeout, timer, pushGkSnackbar, GkSnackbarHost

Form-focused imports are also available from god-kit/vue/form, layout primitives from god-kit/vue/layout, navigation primitives from god-kit/vue/navigation, and data-table primitives from god-kit/vue/data (see Build and bundling).

Maintenance notes

  • Keep this index, the components sidebar in docs/.vitepress/config.ts, and demo registrations in docs/.vitepress/theme/index.ts synchronized in the same PR.
  • Use the checklist in Contributing docs when adding or expanding examples.

Released under the MIT License.