Appearance
Integration hub
Choose a package for your stack. All web adapters use the same init() options and delegate to @stringpush/sdk for overlay and realtime.
Package matrix
| Stack | Package | Guide |
|---|---|---|
| Plain JS / Vite | @stringpush/sdk | Getting started |
| Next.js / Nuxt / SSR | @stringpush/node | SSR |
| Rails / Laravel / Phoenix / Django | DIY HTTP client | Server HTTP client |
| React 18+ | @stringpush/react | React |
| Next.js | @stringpush/react | Next.js |
| Vue 3 | @stringpush/vue | Vue |
| Angular 17+ | @stringpush/angular | Angular |
| React Native | @stringpush/react-native | React Native |
| Hosted demo | @stringpush/sdk | Sample app |
Feature comparison
| Feature | Web SDK + adapters |
|---|---|
| Manifest + bundle load | Yes |
t() + ICU | Yes |
setLocale | Yes |
| Staging overlay | Yes |
data-i18n-key / resolver | Yes |
React Native uses @stringpush/react-native (runtime only, no overlay). See React Native integration.
Shared init shape
ts
{
applicationId: "<uuid>",
environment: "staging" | "production",
locale: "en",
apiKey: "trt_…",
apiBaseUrl: "https://api.platform.stringpush.com",
origin: "https://your-app.example.com",
}Every browser origin must be verified in admin before init() works from that hostname (except localhost dev origins).
Staging overlay
Overlay on staging — edit tokens, launcher, and save behavior.
Environment release — promote, production hotfix, and back-sync staging.
Deploy release — CI promote + publish production after app deploy.
Git sync — export locale JSON to your repo (sync-pr in CI, hosted GitHub App, overlay Ready for merge, or stringpush push inbound). Create stp_… tokens in admin Settings → Git sync.
Production overlay is off by default for new organizations.