Theming - Bitblue

Override component styles globally with ThemeProvider and getTheme

Bitblue components resolve styles through tailwind-variants themes. Wrap your app (or a subtree) in ThemeProvider to override slot classes per component key.

Setup

<script lang="ts">
	import { ThemeProvider } from '.';
</script>

ThemeProvider

<script lang="ts">
	import { ThemeProvider, Button, Alert } from '.';
</script>

<ThemeProvider
	theme={{
		button: {
			base: 'rounded-full tracking-wide'
		},
		alert: {
			base: 'border-l-4'
		}
	}}
>
	<Button>Themed button</Button>
	<Alert>Themed alert</Alert>
</ThemeProvider>

How it works

  1. Each component calls getTheme('componentKey') from context.
  2. Returned partial classes merge with the default tv() theme via clsx / slot class callbacks.
  3. Without a provider, components use built-in defaults from packages/base/src/lib/**/theme.ts.

Common theme keys

KeyComponent
buttonButton
alertAlert
badgeBadge
cardCard
modalModal
drawerDrawer
input / label / helper / search / range / toggleForm controls
progressbarProgressbar
spinnerSpinner
toolbar / toolbarButtonToolbar family
footer / footerBrand / …Footer family
popover / tooltipOverlays

Keys mirror exports from packages/base/src/lib/themes/themes.ts.

Props (ThemeProvider)

PropTypeDescription
themePartial<ThemeConfig>Map of component key → slot class overrides
childrensnippetApp content

Use per-instance class / classes props for one-off overrides; use ThemeProvider for product-wide tokens.


© 2026 Bitblue is a registered trademark. All Rights Reserved.