Skip to content
iv-ui v0.3.0

Quickstart

From an empty SvelteKit route to a working form with feedback in five minutes.

1. Install

bun add @elluzion/iv-ui @tabler/icons-svelte

2. Root layout

Import the theme and mount the two store-driven globals.

src/routes/+layout.svelte· svelte Show Hide
<script lang="ts">
	import { AlertDialog, Toast } from '@elluzion/iv-ui';
	import '@elluzion/iv-ui/theme.css';
	let { children } = $props();
</script>

{@render children()}
<Toast />
<AlertDialog />

3. A form

Components are controlled with bind: or with explicit event handlers. Labels, helper text, and errors are part of the field components.

src/routes/+page.svelte· svelte Show Hide
<script lang="ts">
	import { Button, Field, Input, showToast } from '@elluzion/iv-ui';

	let email = $state('');
	let error = $state('');

	function submit(e: SubmitEvent) {
		e.preventDefault();
		error = email.includes('@') ? '' : 'Enter a valid email address.';
		if (!error) showToast('Invite sent to ' + email, 'success');
	}
</script>

<form onsubmit={submit} novalidate>
	<Field label="Email" error={error} required>
		<Input type="email" placeholder="you@example.com" bind:value={email} />
	</Field>
	<Button type="submit" variant="primary">Send invite</Button>
</form>
Forms Field wraps any control and connects its label, helper text, and error to the control through aria-describedby.

4. An overlay

Source· svelte Show Hide
<script lang="ts">
	import { Button, Dialog } from '@elluzion/iv-ui';
	let open = $state(false);
</script>

<Button variant="primary" onclick={() => (open = true)}>Delete project</Button>

<Dialog bind:open title="Delete project?" size="sm">
	<p>This removes the project and every deployment. It cannot be undone.</p>
	{#snippet footer()}
		<Button variant="ghost">Cancel</Button>
		<Button variant="danger">Delete</Button>
	{/snippet}
</Dialog>
Destructive actions For confirmation flows that must block the page, use showAlertDialog instead of a plain dialog. It mounts once at the root and handles focus and escape.

Next

  • Browse all components — every page lists props, events, and copyable examples.
  • Read theming before overriding colors or spacing.
  • Point an agent at llms.txt or the API corpus at llms-api.txt.
iv-ui
↑ ↓ navigate ↵ open esc close minisearch · 482 records