Install the SDK
npm install @reforgio/sdk-coreRendering from React? Add the hooks package too:
npm install @reforgio/sdk-react@reforgio/sdk-react requires React ≥ 18 and uses @reforgio/sdk-core under the hood.
Two entry points, one package
@reforgio/sdk-core ships a browser entry and a server entry — import the one that matches where your code runs:
| Import | Runs in | Exports |
|---|---|---|
@reforgio/sdk-core | Browser | Reforgio (public-key client), ReforgioError, types |
@reforgio/sdk-core/server | Node.js | ReforgioServer (secret-key client), signUserId, ReforgioError, types |
// Backend (Node.js) — secret key, full access
import { ReforgioServer, ReforgioError } from '@reforgio/sdk-core/server'
// Frontend (browser) — public key + signed user handshake
import { Reforgio, ReforgioError } from '@reforgio/sdk-core'
// React — provider + hooks on top of the browser client
import { ReforgioProvider, useRender } from '@reforgio/sdk-react'The server entry additionally exposes signUserId(userId, signingSecret) — the HMAC helper you’ll need for frontend rendering.