React SDK
React provider, hooks, ledger primitives, and pre-built views (submit-ticket, ticket-detail, conversation, screen recorder). Brings the full Reqdesk surface into a React app without re-implementing the data flow.
Install
pnpm add @reqdesk/sdk-react @reqdesk/sdk-core
# then in your root:
import { ReqdeskProvider } from '@reqdesk/sdk-react'
@reqdesk/sdk-react is the React layer. It wraps @reqdesk/sdk-core in a <ReqdeskProvider> that owns auth, theme, query client, and event bus, then exposes typed hooks and ready-made views you can drop straight into your app.
What ships
<ReqdeskProvider>— single mount point. Reads workspace API key + base URL, hands children a configured TanStack Query client, OIDC auth, and theme tokens.- Ledger primitives —
LedgerButton,LedgerInput,LedgerCard,LedgerBadge,LedgerToggle,LedgerSegmented,LedgerIconButton. Editorial style, theme-aware via--rqd-*CSS variables, no Tailwind dependency. - Pre-built views —
<SubmitTicketView>,<TicketDetailView>,<RecordedStepsList>,<ScreenRecorder>,<InstanceCardList>. Use them whole, or compose smaller pieces. - Hooks —
useReqdesk(),useTickets(),useReplies(),useScreenRecording(). Typed against the same wire shape as the core SDK.
Pairing with the widget
If you’re embedding the floating widget into a React app, @reqdesk/widget re-exports <ReqdeskProvider> + <FloatingWidget> from this package — install it directly instead of building your own provider tree. If you want the views without the floating launcher (a settings page that lists a customer’s tickets, for example), this package is the right entry point.