@galinum/react is the web in-app delivery surface for Galinum. Your agent
creates and targets communications through the
management API; the SDK identifies your users, streams their
behavior, and renders the messages they’re eligible for.
Install
@galinum/react ships as a tarball in each Galinum product release. Install
the tarball your release provides:
The SDK version matches the product release it ships with.
react >= 18 is a peer dependency. The SDK is client-only ("use client") —
in the Next.js App Router, render it inside a Client Component.
Minimal setup
Wrap your app inGalinumProvider with your project’s publishable key
(pk_pub_…, safe to ship in the browser), then drop <InAppMessages/> near
the root:
userId is set the SDK identifies the user,
fetches the messages they’re eligible for, shows one per page view (default
card or your own renderer), and reports impressions, clicks, and dismissals
back so every campaign is measured.
Identify & track
Set the current user, record behavioral events, and see what context is
collected automatically.
In-app messages
How message delivery, rendering, and feedback work — including fully custom
UI.
API reference
Every prop, hook, and type the SDK exports.
Reliability
identify and track never throw into your app — failed requests are
swallowed (and logged in development). A failed message fetch means “no
messages this round”. Campaign CTAs are sanitized against javascript:/data:
URI injection before rendering.