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
- Each component calls
getTheme('componentKey')from context. - Returned partial classes merge with the default
tv()theme viaclsx/ slotclasscallbacks. - Without a provider, components use built-in defaults from
packages/base/src/lib/**/theme.ts.
Common theme keys
| Key | Component |
|---|---|
button | Button |
alert | Alert |
badge | Badge |
card | Card |
modal | Modal |
drawer | Drawer |
input / label / helper / search / range / toggle | Form controls |
progressbar | Progressbar |
spinner | Spinner |
toolbar / toolbarButton | Toolbar family |
footer / footerBrand / … | Footer family |
popover / tooltip | Overlays |
Keys mirror exports from packages/base/src/lib/themes/themes.ts.
Props (ThemeProvider)
| Prop | Type | Description |
|---|---|---|
theme | Partial<ThemeConfig> | Map of component key → slot class overrides |
children | snippet | App content |
Use per-instance class / classes props for one-off overrides; use ThemeProvider for product-wide tokens.