// Compatibility

Check this page before you upgrade a framework that Session kit works with, or to see whether your runtime is supported.

Peer dependenciesCopy Anchor Link

Every peer dependency is optional. Install only the ones the entry points you import use:

Three things to know about these peers:

• Expo. The Expo ranges cover Expo SDK 53 and newer. Install them with npx expo install, so that they match your SDK, as the Expo guide shows.
• React Router with server rendering. /react-router/server needs React Router's middleware: React Router 8, or 7.9 and later with future.v8_middleware.
• React DOM. No entry point imports React DOM.

Tested versionsCopy Anchor Link

CI tests the oldest and the newest version in each range, with one exception: it tests expo-file-system only at its newest. Version 18.1 publishes no exports map, so its types don't resolve under NodeNext.

RuntimesCopy Anchor Link

Session kit runs in browsers, in React Native (Expo SDK 53 and newer, with Hermes and Metro), and in Node.js 20 and newer. Your framework can need a newer Node.js: React Router 8 needs 22.22. Session kit uses these platform features:

• AbortController is required.
• crypto.randomUUID makes session IDs when present. Without it, the client uses crypto.getRandomValues, or Math.random as a last resort.
• Web Locks keep tabs to one refresh at a time when present. Without them, two tabs can refresh at the same instant, as Tabs explains.
• BroadcastChannel lets a createMirrorAuth client follow sign-ins and sign-outs in other tabs, when present.
• Web Crypto is required on the server by @monarcode/session-kit/server, as in Node.js 20 and newer.

TypeScriptCopy Anchor Link

The package is ESM-only. It's checked with TypeScript 6.0.3 under NodeNext and Bundler resolution, with exactOptionalPropertyTypes both on and off.