Integrations
What it plugs into
next-story depends on a few pieces you already run, through small ports you can swap.
- 01
Next.js (App Router)
Middleware mints the journey token; a Route Handler collects. Next.js 15.1 or later.
- 02
Postgres or Supabase
Events land in a daily-partitioned raw_event table through an EventSink. createDrizzleEventSink works with Drizzle against tables shaped like the reference schema.
- 03
Upstash Redis
UpstashStore backs per-site and per-IP-hash rate limits over REST, so it works on the Edge.
- 04
Vercel
Pass the deploy's commit SHA as release_id and every session records which release it saw.
- 05
Claude Code
The next-story-onboarding skill, shipped as a plugin in this repository, walks an agent through installing the library in a Next.js repo.
- 06
Your identity system
An IdentityResolver port: return an anonymous id and, if you have one, a user id.