sonder-init
v0.1.3
Published
One-command setup for Sonder ("Sentry for UX friction"): `npx sonder-init <write_key>` detects your framework (Next, Vite + React, React, or plain HTML), wires @sonderhq/sdk in, and verifies your first friction events. The runtime SDK (@sonderhq/sdk) is i
Maintainers
Readme
sonder-init
One-command setup for Sonder — "Sentry for UX friction."
npx sonder-init <write_key>The wizard:
- Detects your framework — Next.js, Vite + React, React, or plain HTML.
- Wires the SDK in — writes the right provider/init file and touches your
entry (Vite
main.tsx, Nextlayout.tsx, or a<script type="module">for plain HTML), plus a.sonder/config.jsonwith edge masking defaults. - Verifies ingest — sends a sample friction ribbon with your write key and prints the live events it gets back, so you know it works before you ship.
Options:
npx sonder-init <write_key> [--ingest-url <url>] [--board-url <url>] [--fixture]--fixture scaffolds a tiny index.html to try it in an empty folder.
The runtime SDK
sonder-init only scaffolds. The files it writes import the runtime SDK, which
you install into your app:
npm install @sonderhq/sdkSee @sonderhq/sdk for the full
API (semantic autocapture, rage/dead-click primitives, friction-time state
probes) and framework guides. sonder-init ships the same compiled wizard as
that package's sonder-init bin, so the two always move together.
MIT © Sonder
