dolfindevelopers
UI: YOUR APPLICATION CONTROLS THE EXPERIENCE

Start with standalone UI

Use Dolfin's presentation components with your own state and callbacks. They do not fetch data or require DolfinProvider.

Before you start: complete the shared registry setup for your React app.
Loading preview…

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.

Terminal · Bun
bunx --bun shadcn@4.23.0 add @dolfin/ui-base-stat-card
Using npm or pnpm?
Terminal · npm
npx shadcn@4.23.0 add @dolfin/ui-base-stat-card
Terminal · pnpm
pnpm dlx shadcn@4.23.0 add @dolfin/ui-base-stat-card

The 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.

Stat card: standalone UI props and source

02Pass display values

invoice-summary.tsx
"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

Terminal
<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.