---
title: "Quickstart"
description: "From an empty SvelteKit route to a working form with feedback in five minutes."
section: guides
slug: quickstart
url: /docs/quickstart
---

# Quickstart

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

## 1. Install

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

```svelte
<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](/components) — every page lists props, events, and copyable examples.
- Read [theming](/docs/theming) before overriding colors or spacing.
- Point an agent at [llms.txt](/llms.txt) or the API corpus at [llms-api.txt](/llms-api.txt).

## Related

- [Installation](/docs/installation.md)
- [Theming](/docs/theming.md)
- [Accessibility](/docs/accessibility.md)