Skip to content
System

Theme Settings

A ready-made appearance screen for the theme store.

Walkthrough

1. Basic

The whole appearance screen, already bound to the theme store. Change anything here and this page changes with it.

Look

Hairlines, soft corners, the system face. The defaults.

Using the defaults.

<script lang="ts">	import { ThemeSettings } from 'omaris';</script>​<div class="w-full max-w-2xl">	<ThemeSettings /></div>

2. Sections

sections narrows it to the parts you want to expose, and stack drops the tabs — which is what a settings page wants when it already has its own.

Appearance
Accent color
Saturation 100%

How vivid the accent colors are.

Surface tint 100%

How much the greys lean toward the accent.

<script lang="ts">	import { ThemeSettings } from 'omaris';</script>​<div class="w-full max-w-2xl">	<ThemeSettings layout="stack" sections={['color']} customHue={false} resettable={false} /></div>

3. Languages

Four languages built in — English, Arabic, Turkish and Sorani Kurdish. locale picks one, and Arabic and Kurdish turn the screen right to left. Leave it out and the screen follows the page's own lang.

الطابع

Hairlines, soft corners, the system face. The defaults.

تُستخدم الإعدادات الافتراضية.

<script lang="ts">	import { ThemeSettings, SegmentedButton, type ThemeSettingsLocale } from 'omaris';​	let locale = $state<ThemeSettingsLocale>('ar');</script>​<div class="flex w-full max-w-2xl flex-col gap-6">	<SegmentedButton		label="Language"		size="sm"		check={false}		bind:value={() => locale, (v) => (locale = v as ThemeSettingsLocale)}		items={[			{ value: 'en', label: 'English' },			{ value: 'ar', label: 'العربية' },			{ value: 'tr', label: 'Türkçe' },			{ value: 'ckb', label: 'کوردی' }		]}	/>	<ThemeSettings {locale} /></div>

4. Overridden

A narrow side panel, a few words of the product's own, and the cards restyled through classes. The cards fold to fewer columns on their own when the container is narrow.

Color

Appearance
Brand color
Saturation 100%

How vivid the accent colors are.

Surface tint 100%

How much the greys lean toward the accent.

Text

Text size
Typeface

The product's own typeface

Nothing changed yet.

<script lang="ts">	import { ThemeSettings } from 'omaris';</script>​<div class="w-80 max-w-full rounded-xl border border-border bg-surface-container-low p-4">	<ThemeSettings		layout="stack"		sections={['color', 'text']}		labels={{ color: 'Brand color', defaults: 'Nothing changed yet.' }}		classes={{ choice: 'rounded-shape-lg', choiceArt: 'h-12' }}	/></div>

5. Looks

The nine looks, each drawn with its own shape, surface, typeface and density. The colour is the page's: a look never carries one, so what differs here is exactly what choosing it would change.

plain

Plain

Hairlines, soft corners, the system face. The defaults.

Paid
expressive

Expressive

Material 3 Expressive: tonal blocks, big soft containers, pill controls, vivid colour.

Paid
soft

Soft

Pastel and pillowy: low chroma, tinted greys, round everything, room to breathe.

Paid
playful

Playful

Candy colour at full volume, a rounded face, big friendly shapes.

Paid
editorial

Editorial

A magazine: serif headlines, square containers, hairlines, generous margins.

Paid
paper

Paper

Warm, quiet greys and cards that cast a shadow — a desk, not a screen.

Paid
poster

Poster

Loud and flat: saturated tonal blocks, sharp corners, a grotesque face.

Paid
terminal

Terminal

Monospace, compact, square, nearly grey. The developer tool and the trading desk.

Paid
glass

Glass

Liquid glass: cards, bars and menus over a still wallpaper of the theme's hues, that give under a finger.

Paid
<script lang="ts">	import {		Button,		Card,		Chip,		Text,		THEME_LOOKS,		THEME_DEFAULTS,		THEME_PRESETS	} from 'omaris';	import { resolveTheme } from '$lib/theme/resolve.js';	import type { ThemeLookName } from '$lib/theme/looks.js';​	const NAMES = Object.keys(THEME_LOOKS) as ThemeLookName[];​	/* `surface` is the store's default; here each card says its own, since the	 * store is not scoped to a tile. `tonal` is the filled card. */	const CARD = { outlined: 'outlined', tonal: 'filled', elevated: 'elevated' } as const;​	/* The vars a look resolves to, as inline style, so the tile's own	 * `rounded-shape-*`, `gap-*` and typeface read them instead of the page's. */	function vars(name: ThemeLookName) {		const s = THEME_LOOKS[name].settings;		const v = resolveTheme({ ...THEME_DEFAULTS, ...s }, THEME_PRESETS).vars;		return [			`--roundness:${v['--roundness']}`,			v['--roundness-container'] && `--roundness-container:${v['--roundness-container']}`,			`--spacing:${v['--spacing']}`,			v['--font-family-user'] && `--font-family-user:${v['--font-family-user']}`,			`font-family:var(--font-family-user,var(--font-family-sans))`		]			.filter(Boolean)			.join(';');	}</script>​<div class="grid w-full gap-4 sm:grid-cols-2 lg:grid-cols-3">	{#each NAMES as name (name)}		{@const look = THEME_LOOKS[name]}		<div class="flex flex-col gap-2" style={vars(name)}>			<Card variant={CARD[look.settings.surface ?? 'outlined']} size="lg" class="gap-4">				<div class="flex flex-col gap-1">					<Text variant="label-md" tone="muted" class="tracking-wide uppercase">{name}</Text>					<Text as="h3" variant="title-lg">{look.label}</Text>					<Text variant="body-sm" tone="muted">{look.hint}</Text>				</div>				<div class="flex flex-wrap items-center gap-2">					<Button size="xs">Continue</Button>					<Chip size="sm" variant="tonal">Paid</Chip>					<span class="h-7 min-w-16 flex-1 rounded-shape-xs border border-input"></span>				</div>			</Card>		</div>	{/each}</div>