🚀 React Starter Kit v3.0 - Complete Architecture Overhaul

[koistya]

We're excited to announce a transformative update to React Starter Kit that brings cutting-edge technologies and improved developer experience!

🎯 What's New

Complete Stack Modernization

We've completely reimagined React Starter Kit with a focus on performance, type safety, and developer experience:

Frontend Evolution:

• React Router → TanStack Router: Type-safe routing with powerful features like route loaders and search params validation
• Material UI/Joy UI → ShadCN UI + Tailwind CSS v4: Beautiful, accessible components you can copy and paste into your project
• New State Management: Adopted Jotai for atomic, performant state management
• React 19: Leveraging the latest React features including concurrent rendering

Backend Transformation:

• Node.js/Yarn → Bun Runtime: Lightning-fast development with Bun's optimized JavaScript runtime
• REST/GraphQL → tRPC: End-to-end type safety without code generation
• Knex.js → Drizzle ORM: Type-safe database queries with Cloudflare D1 support
• New Auth System: Integrated Better Auth for secure, modern authentication

Infrastructure:

• Dual Deployment Options:
  • Primary: Cloudflare Workers for edge deployment
  • Alternative: Google Cloud Run for containerized server deployment
• Monorepo Structure: Clean workspace organization with app/, api/, edge/, and db/ packages

🤖 AI-Assisted Development Ready

New in v3.0: The template now comes pre-configured with instructions for AI-assisted coding tools! We've added CLAUDE.md with project-specific guidance that helps AI tools understand your codebase structure and conventions.

Supported AI Tools:

• Claude Code - Anthropic's official CLI with deep codebase understanding
• Gemini CLI - Google's AI coding assistant
• GitHub Copilot - Contextual code suggestions in your IDE
• Cursor - AI-powered code editor

The CLAUDE.md file includes:

• Project structure overview
• Tech stack details
• Essential commands
• Code conventions
• Development workflow

This ensures AI assistants provide more accurate, project-specific suggestions and follow your established patterns.

Enhanced CORS & Security

• Implemented environment-aware CORS middleware
• Fixed authentication middleware for better security
• Added proper environment detection for development/production

🔄 Migration Notice

This is a breaking change from previous versions. The entire project structure has been reimagined:

• New monorepo structure with clearly defined workspaces
• Different build and development commands
• Complete UI component replacement
• New routing and state management patterns

🚦 Getting Started

# Clone the repository
git clone https://github.com/kriasoft/react-starter-kit.git
cd react-starter-kit

# Install dependencies with Bun
bun install

# Start development
bun dev

📚 Documentation

The README has been completely rewritten to guide you through the new architecture. Check out:

• Quick start guide
• New project structure
• Updated deployment instructions
• Modern development workflow
• AI tools configuration guide

🙏 Acknowledgments

This massive update wouldn't have been possible without the amazing open-source community and the teams behind Bun, TanStack, ShadCN UI, Drizzle, and tRPC.

💬 Feedback

We'd love to hear your thoughts on these changes! Please share your feedback, questions, or migration experiences in this discussion thread.

Happy coding! 🎉

---

Note: If you're currently using an older version, we recommend starting fresh with the new template rather than attempting an in-place migration due to the extensive architectural changes.