Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
React Kit · Boson Protocol
Skip to content

React Kit

@bosonprotocol/react-kit ships React components and hooks layered on top of the Core SDK. It's also the engine behind the embeddable widgets — the widgets are deployed React Kit apps.

Install

pnpm add @bosonprotocol/react-kit @bosonprotocol/core-sdk @bosonprotocol/ethers-sdk react@^18 react-dom@^18

What's in the box

  • Provider — wraps your app and constructs a CoreSDK from a configId.
  • Hooks — useOffers, useExchanges, useFunds, etc. They wrap subgraph queries with React Query.
  • Components — <CommitButton />, <RedemptionFlow />, <FinanceCard />. Higher-level than raw hooks; less flexible.

When to use React Kit vs. the SDK directly

  • Use React Kit when you want pre-built UI for the common buyer flow.
  • Use Core SDK + your own React when your UI is custom and you want full control.

Versioning

Follow core-components — React Kit ships alongside the SDK.

Reference

See Reference → React Kit for the component and hook catalogue.