Migrate to TanStack Start Beta with Vite + Nitro

[diogoparente]

🚀 Migrate to TanStack Start Beta with Vite + Nitro

Overview

This pull request implements the complete migration from TanStack Start Alpha to the new Beta structure as outlined in the official TanStack Start Beta tracking discussion. This migration modernizes the project architecture by adopting Vite as the primary build tool and restructuring the codebase to be more "Vite-native."

🎯 Motivation

The migration addresses several key improvements introduced in TanStack Start Beta:

• Vite + Nitro Integration: TanStack Start is now a Vite plugin, providing better performance, faster build times, and improved developer experience
• Improved API Routes: Migration from API Routes to the enhanced "Server Routes" system with better functionality and developer ergonomics
• Directory Structure Modernization: Moving from ./app to ./src aligns with Vite ecosystem conventions and provides a better "new user experience"
• Package Updates: Adoption of the new @tanstack/react-start package (renamed from @tanstack/start)

📋 Changes Implemented

1. Core Infrastructure Updates (8f3d4a9, af120cb)

• ✅ Migrated from app.config.ts to vite.config.ts with TanStack Start plugin
• ✅ Updated package.json scripts to use Vite commands (vite dev, vite build)
• ✅ Updated to latest TanStack dependencies including @tanstack/react-start

2. Directory Structure Migration (9db90f3, d746bb6, dd1534e, 6ba8922, c794897)

• ✅ Moved entire codebase from ./app/ to ./src/ directory
• ✅ Updated TypeScript path aliases from app/* to src/*
• ✅ Migrated all components, hooks, utilities, and route files
• ✅ Updated all import statements to use @/ alias pointing to ./src/
• ✅ Cleaned up old directory structure

3. Router Configuration (d2de5ee)

• ✅ Added required src/router.tsx with createRouter function export
• ✅ Configured router with scroll restoration and proper TypeScript module declaration

4. API Routes → Server Routes Migration (affbbc9)

• ✅ BREAKING: Migrated from createAPIFileRoute to createServerFileRoute
• ✅ BREAKING: Updated exports from APIRoute to ServerRoute
• ✅ Enhanced auth API route with new Server Routes capabilities

5. Configuration Updates (4151ec5)

• ✅ Updated drizzle.config.ts to point to src/database/schema.ts
• ✅ Updated components.json with new path aliases
• ✅ Updated .gitignore for new TanStack Start structure

🔄 Breaking Changes

As per the official migration guide:

1. API Routes Format:

   - export const APIRoute = createAPIFileRoute('/api/auth/$')({
   + export const ServerRoute = createServerFileRoute('/api/auth/$').methods({

2. Directory Structure: All application code moved from app/ to src/

3. Configuration: Build system now uses Vite instead of custom TanStack Start configuration

🎉 Benefits

• Performance: Vite's fast HMR and optimized build process
• Developer Experience: Better debugging, faster builds, and improved tooling
• Future-Proof: Aligned with TanStack Start's roadmap and Vite ecosystem
• Enhanced API Capabilities: Server Routes provide more functionality than the previous API Routes

🔗 References

• TanStack Start Beta Tracking
• TanStack Router v1.121.34

✅ Testing

• Development server starts correctly with pnpm dev
• Build process completes without errors with pnpm build
• Basic authentication flow works with new Server Routes
• All components render correctly with new import paths

---

Note: This migration follows the official TanStack Start Beta guidelines and positions the project for continued compatibility with future TanStack updates.

[vercel]

@diogoparente is attempting to deploy a commit to the Better Auth Team on Vercel.

A member of the Team first needs to authorize it.