This quickstart adds Trace to a Svelte or SvelteKit app with @trace-id/sdk-svelte. The SDK is a Svelte store: create it once, read it with $, and call getData when the user acts.
Before you start
You need a running Trace server and a public key (pk_...) whose allowed origins include your app. The quick start guide covers both.
- 1
Install the SDK
npm install @trace-id/sdk-sveltepnpm add @trace-id/sdk-svelteyarn add @trace-id/sdk-sveltebun add @trace-id/sdk-svelte - 2
Create the store
Create it in a shared module so every component uses the same client.
TypeScript// src/lib/trace.ts import { createVisitorData } from '@trace-id/sdk-svelte'; import { PUBLIC_TRACE_ENDPOINT, PUBLIC_TRACE_KEY } from '$env/static/public'; export const visitor = createVisitorData({ apiKey: PUBLIC_TRACE_KEY, endpoint: PUBLIC_TRACE_ENDPOINT }, { immediate: false });Outside SvelteKit, pass the values directly instead of importing them from
$env. - 3
Identify on submit
Svelte<!-- SignupForm.svelte --> <script lang="ts"> import { visitor } from '$lib/trace'; let email = ''; async function submit() { const result = await visitor.getData({ tags: { action: 'signup' } }); // null if Trace is unavailable await fetch('/api/signup', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ email, eventId: result?.eventId }), }); } </script> <form on:submit|preventDefault={submit}> <input bind:value={email} type="email" required /> <button disabled={$visitor.isLoading}>Create account</button> </form>The store holds
{ data, error, isLoading }. Collection only runs in the browser, never during server rendering. - 4
Verify on your server
In SvelteKit, verify in a
+server.tsendpoint or a form action with@trace-id/sdk-node. Other backends: