Skip to main content
RefactKit is built on a carefully selected set of technologies that prioritize type safety, performance, and universal deployment. Every dependency listed below is already installed and wired together in the boilerplate. This page is a quick reference for understanding what each package does, which version you are running, and where to find its official documentation.

​
Full dependency table

​
Dependency coupling warnings

Several packages in RefactKit are tightly coupled and must not be updated independently. Upgrading one without the other can cause the SSR server to crash or break authentication.
TanStack Start + Nitro v3 are tightly coupled. The nitro package is pinned to 3.0.x-beta. Do not run pnpm update on @tanstack/react-start, @tanstack/react-router, or nitro without verifying compatibility first — version mismatches will crash the SSR server.
Better Auth (v1.6+) updates often introduce new database columns, particularly for the organization plugin. Always check the Better Auth changelog before updating and run npx drizzle-kit push immediately after to sync your schema.
React 19: RefactKit uses React 19 Server Functions and Actions. Do not install UI libraries that require React 18 as a peer dependency, and never downgrade the core react or react-dom packages.
Do not run pnpm update across all packages blindly. The pinned versions of nitro, @tanstack/react-start, and better-auth exist for stability reasons. Update these packages one at a time, verify the build and tests pass after each update.