# iv-ui > A Svelte 5 component library with a monochrome, console-grade design system. Token-pure, accessible, runes-native. Version 0.3.0 · 37 components · Svelte 5 · MIT iv-ui is a Svelte 5 component library distributed as `@elluzion/iv-ui` through GitHub Packages. Install `@tabler/icons-svelte` as a peer dependency, import `@elluzion/iv-ui/theme.css` once in the root layout, and mount `` and `` once. ## Rules - Svelte 5 runes only: `$props()`, `$state()`, `$derived()`, `$effect()`. - Import components from `@elluzion/iv-ui`; import `@elluzion/iv-ui/theme.css` once. - Never hardcode hex colors. Override `--iv_*` tokens instead. - Every component accepts `onclick` and the legacy `on:click` form. - Icon-only buttons need `aria-label`; avatars need `alt`. - Mount `` and `` once; use `showToast()` and `showAlertDialog()`. - All components forward `class`, `id`, `style`, `aria-*`, and `data-*` through rest props. - Pages exist as Markdown at the same URL with `.md` appended. ## Documentation - [Installation](https://iv-ui.vercel.app/docs/installation.md): Configure GitHub Packages, install the package, and import the theme once. - [Quickstart](https://iv-ui.vercel.app/docs/quickstart.md): From an empty SvelteKit route to a working form with feedback in five minutes. - [Theming](https://iv-ui.vercel.app/docs/theming.md): Override semantic tokens once and every component follows — light, dark, and custom. - [Accessibility](https://iv-ui.vercel.app/docs/accessibility.md): What every component guarantees, and what your app still has to provide. - [For agents](https://iv-ui.vercel.app/docs/for-agents.md): Machine-readable entry points: llms.txt, full corpus, API-only corpus, and JSON. - [Tokens](https://iv-ui.vercel.app/foundations/tokens.md): Every design decision is a CSS custom property. This is the full generated list. - [Color](https://iv-ui.vercel.app/foundations/colors.md): A monochrome canvas with one brass accent and three status families. - [Typography](https://iv-ui.vercel.app/foundations/typography.md): IBM Plex Mono is the interface voice; Sora is reserved for headings and prose. - [Motion](https://iv-ui.vercel.app/foundations/motion.md): Short, decisive transitions — and an immediate stop when the user asks for less. ## Components ### Form & Input - [Button](https://iv-ui.vercel.app/components/button.md): Triggers an action or submits a form. - [Input](https://iv-ui.vercel.app/components/input.md): A single-line text field with an optional label, helper, and error state. - [Checkbox](https://iv-ui.vercel.app/components/checkbox.md): A binary choice with an optional label and a mixed state. - [Field](https://iv-ui.vercel.app/components/field.md): Labels a custom control and renders its helper or error message. - [InputGroup](https://iv-ui.vercel.app/components/input-group.md): Joins an input with prefix and suffix addons inside one frame. - [NativeSelect](https://iv-ui.vercel.app/components/native-select.md): A native select element with the library field treatment. - [RadioGroup](https://iv-ui.vercel.app/components/radio-group.md): A set of mutually exclusive options with one selected value. - [Select](https://iv-ui.vercel.app/components/select.md): A custom listbox with search, multiple selection, and clearing. - [Slider](https://iv-ui.vercel.app/components/slider.md): Selects a number, or a range, along a track. - [Switch](https://iv-ui.vercel.app/components/switch.md): An on/off control that applies immediately. - [Textarea](https://iv-ui.vercel.app/components/textarea.md): A multi-line text field with an optional count and error state. - [Toggle](https://iv-ui.vercel.app/components/toggle.md): A pressable button that keeps a checked state. - [ToggleGroup](https://iv-ui.vercel.app/components/toggle-group.md): A row of toggles with single or multiple selection. - [ButtonGroup](https://iv-ui.vercel.app/components/button-group.md): Joins related buttons into one segmented control. ### Layout & Navigation - [Accordion](https://iv-ui.vercel.app/components/accordion.md): A stack of collapsible sections; one or several can be open. - [Article](https://iv-ui.vercel.app/components/article.md): A readable page body with an optional title and standfirst. - [Breadcrumb](https://iv-ui.vercel.app/components/breadcrumb.md): Shows the path to the current page. - [Card](https://iv-ui.vercel.app/components/card.md): A bordered surface for grouped content and actions. - [Collapsible](https://iv-ui.vercel.app/components/collapsible.md): A single section that expands to reveal content. - [Separator](https://iv-ui.vercel.app/components/separator.md): A hairline rule that separates content. - [Tabs](https://iv-ui.vercel.app/components/tabs.md): Switches between panels that share one context. ### Overlays - [AlertDialog](https://iv-ui.vercel.app/components/alert-dialog.md): A blocking confirmation that returns a decision through an action. - [ContextMenu](https://iv-ui.vercel.app/components/context-menu.md): Opens a menu at the pointer or from the keyboard Menu key. - [Dialog](https://iv-ui.vercel.app/components/dialog.md): A modal surface for focused tasks and confirmations. - [Menu](https://iv-ui.vercel.app/components/menu.md): A vertical list of commands, options, or links. - [Popover](https://iv-ui.vercel.app/components/popover.md): A floating panel anchored to an element. - [Sheet](https://iv-ui.vercel.app/components/sheet.md): A panel that slides in from an edge for secondary flows. - [Toast](https://iv-ui.vercel.app/components/toast.md): A single transient notification driven by the toast store. - [Tooltip](https://iv-ui.vercel.app/components/tooltip.md): A short label shown on hover or focus. ### Feedback & Status - [Alert](https://iv-ui.vercel.app/components/alert.md): An inline message for information, success, warning, or error. - [EmptyState](https://iv-ui.vercel.app/components/empty-state.md): Explains why an area has no content and offers the next step. - [LoadingSpinner](https://iv-ui.vercel.app/components/loading-spinner.md): An indeterminate indicator for short waits. - [Progress](https://iv-ui.vercel.app/components/progress.md): Shows how much of a task is complete. - [Skeleton](https://iv-ui.vercel.app/components/skeleton.md): A pulsing placeholder that holds the shape of loading content. ### Display & Misc - [Avatar](https://iv-ui.vercel.app/components/avatar.md): A circular identity image with initials and an optional presence dot. - [Badge](https://iv-ui.vercel.app/components/badge.md): A compact label for status, counts, or categories. - [Shortcut](https://iv-ui.vercel.app/components/shortcut.md): Renders a keyboard combination as key caps. ## Machine-readable - [Full documentation](https://iv-ui.vercel.app/llms-full.txt) - [API corpus, no examples](https://iv-ui.vercel.app/llms-api.txt) - [API index](https://iv-ui.vercel.app/api/index.json) - [Search index](https://iv-ui.vercel.app/search.json) - Per component: `https://iv-ui.vercel.app/api/.json`