+```
+
+## Validation
+
+```ts
+import { validateHotkey } from '@tanstack/svelte-hotkeys'
+
+const result = validateHotkey('Alt+A')
+```
diff --git a/docs/framework/svelte/guides/hotkey-recording.md b/docs/framework/svelte/guides/hotkey-recording.md
new file mode 100644
index 0000000..a143859
--- /dev/null
+++ b/docs/framework/svelte/guides/hotkey-recording.md
@@ -0,0 +1,78 @@
+---
+title: Hotkey Recording Guide
+id: hotkey-recording
+---
+
+TanStack Hotkeys provides the `createHotkeyRecorder` function for building shortcut customization UIs in Svelte.
+
+## Basic Usage
+
+```svelte
+
+
+
+
+ {#if recorder.isRecording}
+
+ {/if}
+
+```
+
+## Return Value
+
+- `isRecording`: whether recording is active
+- `recordedHotkey`: the most recently recorded hotkey
+- `startRecording()`: start listening for key presses
+- `stopRecording()`: stop listening and keep the current recording
+- `cancelRecording()`: stop listening and discard the in-progress recording
+
+## Options
+
+```ts
+createHotkeyRecorder({
+ onRecord: (hotkey) => {},
+ onCancel: () => {},
+ onClear: () => {},
+})
+```
+
+Options can also be reactive:
+
+```svelte
+
+```
+
+## Recording Behavior
+
+- Modifier-only presses do not complete a recording.
+- Modifier plus key combinations record the full shortcut.
+- Escape cancels recording.
+- Backspace and Delete clear the shortcut.
+- Recorded values are normalized to portable `Mod` format.
diff --git a/docs/framework/svelte/guides/hotkeys.md b/docs/framework/svelte/guides/hotkeys.md
new file mode 100644
index 0000000..88c4a7c
--- /dev/null
+++ b/docs/framework/svelte/guides/hotkeys.md
@@ -0,0 +1,138 @@
+---
+title: Hotkeys Guide
+id: hotkeys
+---
+
+Use `createHotkey` for global shortcuts and `createHotkeyAttachment` for element-scoped shortcuts. This keeps the common global case simple while making scoped behavior feel native to Svelte 5.
+
+## Global hotkeys
+
+```svelte
+
+```
+
+The callback receives the original `KeyboardEvent` as the first argument and a `HotkeyCallbackContext` as the second:
+
+```ts
+createHotkey('Mod+S', (event, context) => {
+ console.log(context.hotkey)
+ console.log(context.parsedHotkey)
+})
+```
+
+## Scoped hotkeys
+
+Use attachments instead of capturing an element ref just to pass it back into the API.
+
+```svelte
+
+
+
Panel content
+```
+
+## Reactive inputs
+
+Hotkeys can take plain values for static registrations or getter functions when the hotkey or options depend on reactive state.
+
+### Reactive `enabled`
+
+```svelte
+
+```
+
+### Reactive hotkey values
+
+```svelte
+
+```
+
+## Default options
+
+Set defaults explicitly with `setHotkeysContext` when a subtree needs shared behavior:
+
+```svelte
+
+```
+
+## Common Options
+
+### `requireReset`
+
+```ts
+createHotkey('Escape', () => closePanel(), { requireReset: true })
+```
+
+### `ignoreInputs`
+
+```ts
+createHotkey('K', () => openSearch())
+createHotkey('Enter', () => submit(), { ignoreInputs: false })
+```
+
+### `conflictBehavior`
+
+```ts
+createHotkey('Mod+S', () => save(), { conflictBehavior: 'replace' })
+```
+
+### `platform`
+
+```ts
+createHotkey('Mod+S', () => save(), { platform: 'mac' })
+```
+
+## Automatic Cleanup
+
+Global hotkeys are automatically unregistered when the owning component unmounts. Attachment-based hotkeys clean themselves up when the attached element is removed or when reactive inputs change.
+
+## The Hotkey Manager
+
+You can always reach for the underlying manager directly:
+
+```ts
+import { getHotkeyManager } from '@tanstack/svelte-hotkeys'
+
+const manager = getHotkeyManager()
+manager.isRegistered('Mod+S')
+manager.getRegistrationCount()
+```
diff --git a/docs/framework/svelte/guides/key-state-tracking.md b/docs/framework/svelte/guides/key-state-tracking.md
new file mode 100644
index 0000000..0aedcc0
--- /dev/null
+++ b/docs/framework/svelte/guides/key-state-tracking.md
@@ -0,0 +1,98 @@
+---
+title: Key State Tracking Guide
+id: key-state-tracking
+---
+
+TanStack Hotkeys provides three Svelte functions for tracking live keyboard state: `getHeldKeys`, `getHeldKeyCodesMap`, and `getIsKeyHeld`.
+
+## `getHeldKeys`
+
+```svelte
+
+
+
+```
+
+## Under the Hood
+
+All three functions subscribe to the singleton `KeyStateTracker`:
+
+```ts
+import { getKeyStateTracker } from '@tanstack/svelte-hotkeys'
+
+const tracker = getKeyStateTracker()
+tracker.getHeldKeys()
+tracker.isKeyHeld('Shift')
+```
diff --git a/docs/framework/svelte/guides/sequences.md b/docs/framework/svelte/guides/sequences.md
new file mode 100644
index 0000000..2211644
--- /dev/null
+++ b/docs/framework/svelte/guides/sequences.md
@@ -0,0 +1,109 @@
+---
+title: Sequences Guide
+id: sequences
+---
+
+TanStack Hotkeys supports multi-key sequences in Svelte, where keys are pressed one after another rather than simultaneously.
+
+## Global sequences
+
+```svelte
+
+```
+
+## Scoped sequences
+
+Use `createHotkeySequenceAttachment` when a sequence should only be active while a specific element owns focus.
+
+```svelte
+
+
+
+ Focus here, then press g then g
+
+```
+
+## Sequence options
+
+```ts
+createHotkeySequence(['G', 'G'], callback, {
+ timeout: 1000,
+ enabled: true,
+})
+```
+
+### Reactive `enabled`
+
+```svelte
+
+```
+
+## Default options
+
+```svelte
+
+```
+
+## Common Patterns
+
+### Vim-Style Navigation
+
+```ts
+createHotkeySequence(['G', 'G'], () => scrollToTop())
+createHotkeySequence(['G', 'Shift+G'], () => scrollToBottom())
+createHotkeySequence(['D', 'D'], () => deleteLine())
+createHotkeySequence(['D', 'W'], () => deleteWord())
+createHotkeySequence(['C', 'I', 'W'], () => changeInnerWord())
+```
+
+### Konami Code
+
+```ts
+createHotkeySequence(
+ ['ArrowUp', 'ArrowUp', 'ArrowDown', 'ArrowDown', 'B', 'A'],
+ () => enableEasterEgg(),
+ { timeout: 2000 },
+)
+```
+
+## Under the Hood
+
+`createHotkeySequence` uses the singleton `SequenceManager`. You can also access it directly:
+
+```ts
+import {
+ createSequenceMatcher,
+ getSequenceManager,
+} from '@tanstack/svelte-hotkeys'
+
+const manager = getSequenceManager()
+const matcher = createSequenceMatcher(['G', 'G'], { timeout: 1000 })
+```
diff --git a/docs/framework/svelte/quick-start.md b/docs/framework/svelte/quick-start.md
new file mode 100644
index 0000000..44290bc
--- /dev/null
+++ b/docs/framework/svelte/quick-start.md
@@ -0,0 +1,170 @@
+---
+title: Quick Start
+id: quick-start
+---
+
+## Installation
+
+Don't have TanStack Hotkeys installed yet? See the [Installation](../../installation) page for instructions.
+
+## Your First Hotkey
+
+Use `createHotkey` for global shortcuts and attachments for element-scoped shortcuts.
+
+```svelte
+
+
+
Press Cmd+S (Mac) or Ctrl+S (Windows) to save
+```
+
+The `Mod` modifier automatically resolves to `Meta` (Command) on macOS and `Control` on Windows/Linux, so your shortcuts work across platforms without extra logic.
+
+## Common Patterns
+
+### Multiple global hotkeys
+
+```svelte
+
+```
+
+### Scoped hotkeys with attachments
+
+```svelte
+
+
+
+ Register multi-key sequences (like Vim commands). Keys must be pressed
+ within the timeout window (default: 1000ms).
+
+
+
+
+
+
Vim-Style Commands
+
+
+
+
Sequence
+
Action
+
+
+
+
+
+ gg
+
+
Go to top
+
+
+
+ G (Shift+G)
+
+
Go to bottom
+
+
+
+ dd
+
+
Delete line
+
+
+
+ yy
+
+
Yank (copy) line
+
+
+
+ dw
+
+
Delete word
+
+
+
+ ciw
+
+
Change inner word
+
+
+
+
+
+
+
Fun Sequences
+
+
+
Konami Code (Partial)
+
+ ↑↑↓↓
+
+ Use arrow keys within 1.5 seconds
+
+
+
Side to Side
+
+ ←→←→
+
+ Arrow keys within 1.5 seconds
+
+
+
Spell It Out
+
+ hello
+
+ Type "hello" quickly
+
+
+
+
+ {#if lastSequence}
+
+ Triggered:
+ {lastSequence}
+
+ {/if}
+
+
+
Input handling
+
+ Sequences are not detected when typing in text inputs, textareas,
+ selects, or contenteditable elements. Button-type inputs (
+ type="button", submit, reset)
+ still receive sequences. Focus the input below and try g
+ g or h
+ e
+ l
+ l
+ o — nothing will trigger. Click outside to try again.
+
+
+
+
+
+
Usage
+
{`import { createHotkeySequence } from '@tanstack/svelte-hotkeys'
+
+`}
+ Last triggered:
+ {formatForDisplay(lastHotkey)}
+
+ {/if}
+
+
+ Press Escape to reset all counters
+
+
+
+
Scoped Keyboard Shortcuts
+
+ Shortcuts can be scoped to specific DOM elements using the
+ target option. This allows different shortcuts to work in different
+ parts of your application.
+
+ These shortcuts only work when the modal is open and focused.
+ The Escape key here won't conflict with the global Escape
+ handler.
+
+
+
+
+ {/if}
+
+
+
+
Text Editor (Scoped)
+
Focus the editor below and try:
+
+
+ {formatForDisplay('Mod+S')} — Save editor content
+
+
{formatForDisplay('Mod+/')} — Add comment
+
{formatForDisplay('Mod+K')} — Clear editor
+
+
+
Editor shortcuts: {editorShortcutCount}x
+
+ These shortcuts only work when the editor is focused. Notice that {formatForDisplay('Mod+S')}
+ here doesn't conflict with the global
+ {formatForDisplay('Mod+S')}
+ shortcut.
+
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+
+# TanStack Hotkeys
+
+> [!NOTE]
+> TanStack Hotkeys is pre-alpha (prototyping phase). We are actively developing the library and are open to feedback and contributions.
+
+Type-safe keyboard shortcuts for the web. Template-string bindings, parsed objects, a cross-platform `Mod` key, a singleton Hotkey Manager, and utilities for cheatsheet UIs—built to stay SSR-friendly.
+
+- Type-safe bindings — template strings (`Mod+Shift+S`, `Escape`) or parsed objects for full control
+- Flexible options — `keydown`/`keyup`, `preventDefault`, `stopPropagation`, conditional enabled, `requireReset`
+- Cross-platform Mod — maps to Cmd on macOS and Ctrl on Windows/Linux
+- Batteries included — validation + matching, sequences (Vim-style), key-state tracking, recorder UI helpers, framework adapters, and devtools
+
+### Read the docs →
+
+
+
+> [!NOTE]
+> You may know **TanStack Hotkeys** by our adapter names, too!
+>
+> - [**React Hotkeys**](https://tanstack.com/hotkeys/latest/docs/framework/react/react-hotkeys)
+> - [**Preact Hotkeys**](https://tanstack.com/hotkeys/latest/docs/framework/preact/preact-hotkeys)
+> - [**Solid Hotkeys**](https://tanstack.com/hotkeys/latest/docs/framework/solid/reference)
+> - [**Angular Hotkeys**](https://tanstack.com/hotkeys/latest/docs/framework/angular/reference)
+> - [**Vue Hotkeys**](https://tanstack.com/hotkeys/latest/docs/framework/vue/reference)
+> - [**Svelte Hotkeys**](https://tanstack.com/hotkeys/latest/docs/framework/svelte/reference)
+
+## Get Involved
+
+- We welcome issues and pull requests!
+- Participate in [GitHub discussions](https://github.com/TanStack/hotkeys/discussions)
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
+- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+
+## Partners
+
+
+We're looking for TanStack Hotkeys Partners to join our mission! Partner with us to push the boundaries of TanStack Hotkeys and build amazing things together.
+
+
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+