Start with standalone UI
Use Dolfin's presentation components with your own state and callbacks. They do not fetch data or require DolfinProvider.
01Example: install your first UI component
The private registry setup is shared by UI and SDK components. If you followed an older bookmark here, use that guide first.
This example installs a Stat card so you can try a small, provider-free component. It is not a required base installation for other components.
bunx --bun shadcn@4.23.0 add @dolfin/ui-base-stat-cardUsing npm or pnpm?
npx shadcn@4.23.0 add @dolfin/ui-base-stat-cardpnpm dlx shadcn@4.23.0 add @dolfin/ui-base-stat-cardThe CLI installs editable source under components/dolfin/ui/ with its shadcn primitives and theme dependencies. To install something else, replace ui-base-stat-card with the name from your chosen catalog item's Standalone UI tab.
02Pass display values
"use client";
import { StatCard } from "@/components/dolfin/ui/base/stat-card";
export function InvoiceSummary() {
return <StatCard label="Outstanding invoices" value="£12,400" sub="Across 12 invoices" />;
}This works without an SDK or query provider. Your controller supplies already formatted values; the component renders them.
03Connect your application
<StatCard
label="Outstanding invoices"
value={formattedOutstanding}
selected={showOutstanding}
onSelect={() => setShowOutstanding(!showOutstanding)}
/>In this wiring example, your application owns the filter state and formatted total. Supply them from a GraphQL query, SDK hooks or your controller. Finance logic, permissions and mutations stay outside the UI.
For complete tables, forms and screens, browse standalone UI. For ready-made data access and workflows, start with the SDK.