# 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`