Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.refactkit.com/llms.txt

Use this file to discover all available pages before exploring further.

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

LayerTechnologyVersionRole
Meta-frameworkTanStack StartlatestFull-stack React framework. Provides SSR, file-based routing, server functions, and hydration via Nitro v3.
Server engineNitro v33.0.x-betaUniversal deployment engine powering SSR, server functions, and API routes. Single build targets Vercel, Cloudflare, and Node.js.
UI frameworkReact19.2+Core UI library. Uses React 19 features including Server Functions, Actions, and the use hook.
RouterTanStack RouterlatestType-safe, file-based routing with beforeLoad guards, loaders, search param validation, and code splitting.
Data fetchingTanStack Query5.xServer-state synchronization. Provides the queryOptions factory pattern and ensureQueryData for SSR cache seeding.
FormsTanStack Form1.xType-safe form state management with Zod validators and field-level error tracking.
TablesTanStack Table8.xHeadless table engine used for the members list, gallery grid, and other data tables.
AuthenticationBetter Auth1.6+Full auth system: email/password, OAuth (Google), organizations, RBAC, rate limiting, and OWASP-compliant session management.
ORMDrizzle ORM0.45+Type-safe SQL query builder. Schema-as-code with pgTable, relational queries, and zero-overhead generated SQL.
DatabaseSupabase (PostgreSQL)Managed PostgreSQL with connection pooling (port 6543), Row Level Security, and a visual dashboard.
StorageSupabase StorageS3-compatible object storage for avatars, logos, and gallery images. All uploads run server-side via the service role key.
StylingTailwind CSSv4Utility-first CSS with @theme directives, CSS variables, and ultra-fast Vite plugin compilation.
UI primitivesshadcn/ui (Base UI)4.5+Accessible WAI-ARIA components built on Base UI primitives. Preset-based theming powered by Tailwind CSS v4.
AnimationsFramer Motion12.xSmooth page transitions and micro-interactions.
EmailResendTransactional email API for verification, password reset, invitations, and security alerts.
i18ni18next26.xCustom React context wrapping i18next. Supports 5 languages (EN, FR, ES, PT, AR) with RTL and cookie-based locale persistence.
ValidationZod4.xRuntime type validation for server functions, form inputs, and search params.
Build toolVite8.xNext-gen build tool with plugins for TanStack Start, React, Tailwind CSS, and Nitro.
Code qualityBiome2.4+Rust-based linter and formatter replacing ESLint and Prettier. Up to 10x faster.
Unit testsVitest4.xFast unit and integration testing with JSDOM, React Testing Library, and v8 coverage.
E2E testsPlaywright1.59+Cross-browser end-to-end testing across Chromium, Firefox, and WebKit. Auto-starts the dev server before running tests.
Type systemTypeScript5.xStrict-mode TypeScript across the entire codebase — client, server, and database schema.

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.