dolfindevelopers
GUIDES

Theming

Components use your shadcn/ui CSS variables, so they match your app by default. You can also override tokens from the provider.

Use your existing shadcn theme

Dolfin components inherit your semantic tokens. The base theme adds finance-specific tokens without replacing your existing colours or fonts.

Terminal
bunx --bun shadcn@4.23.0 add @dolfin/base-theme

Starting fresh? @dolfin/base-theme-stone adds Dolfin’s stone palette for light and dark modes.

Preview themes

Loading preview…

Preview themes are isolated from the documentation. Change the theme above to see the actual component adapt.

Override tokens from the provider

app.tsx
<DolfinProvider
  {...connectionProps}
  theme={{
    primary: "oklch(0.55 0.14 220)",
    radius: "0.75rem",
    fontFamily: "Your Brand Font, sans-serif"
  }}
>
  {children}
</DolfinProvider>

connectionProps represents your configured provider authentication and API URL. The provider applies its theme at the document root: use one theme per application document.