Svelte SDK recipes
Developer preview
This feature is in developer preview. Use with caution as it may change unexpectedly. For more information, contact us.
To add Uniform to an existing SvelteKit app, follow Manual setup.
Building a component with text, rich text, and slots#
<!-- src/lib/components/Article.svelte -->
<script lang="ts">
import { UniformText, UniformRichText, UniformSlot } from '@uniformdev/canvas-svelte';
import type { ComponentProps } from '@uniformdev/canvas-svelte';
interface Props extends ComponentProps<{
title?: string;
subtitle?: string;
}> {}
let { title, subtitle, component }: Props = $props();
</script>
<article>
<UniformText parameterId="title" as="h1" placeholder="Article title" />
<UniformText parameterId="subtitle" as="p" placeholder="Article subtitle" />
<div class="grid">
<div class="main">
<UniformRichText parameterId="body" as="div" placeholder="Write your article" />
</div>
<aside>
<UniformSlot name="sidebar" />
</aside>
</div>
<section>
<h2>Related</h2>
<UniformSlot name="relatedContent" />
</section>
</article>
Component with quirk-based personalization#
<!-- src/lib/components/PersonalizedGreeting.svelte -->
<script lang="ts">
import { getQuirks, getScores } from '@uniformdev/context-svelte';
const quirks = getQuirks();
const scores = getScores();
const topInterest = $derived(() => {
const entries = Object.entries(scores.current);
if (entries.length === 0) return null;
return entries.sort(([, a], [, b]) => b - a)[0]?.[0];
});
</script>
<div>
{#if quirks.current?.country}
<p>Welcome from {quirks.current.country}!</p>
{/if}
{#if topInterest()}
<p>We see you're interested in {topInterest()}.</p>
{/if}
</div>
Forget visitor data (reset personalization)#
<!-- src/lib/components/ForgetMe.svelte -->
<script lang="ts">
import { getUniformContext } from '@uniformdev/context-svelte';
const { context } = getUniformContext();
const forgetMe = async () => {
await context.forget(true);
};
</script>
<button onclick={forgetMe}>Forget me</button>
DevTools integration#
Enable the Uniform Context DevTools browser extension for debugging:
<script lang="ts">
import {
Context,
CookieTransitionDataStore,
enableContextDevTools,
enableDebugConsoleLogDrain,
} from '@uniformdev/context';
const context = new Context({
manifest,
defaultConsent: true,
transitionStore: new CookieTransitionDataStore({
serverCookieValue: undefined,
}),
plugins: [
enableContextDevTools(),
enableDebugConsoleLogDrain('debug'),
],
});
</script>
The DevTools extension lets you inspect and modify visitor scores and quirks in real time during development.