create-tanstack-hono-start 🚀

The fastest way to create modern React 19 full-stack applications

A lightning-fast CLI that scaffolds production-ready apps with React 19, TanStack Router, Hono API, TypeScript, and AI integration. Perfect alternative to create-react-app with full-stack capabilities built-in.

Why This CLI?

✨ Zero Configuration - Works out of the box
🚀 Full-Stack Ready - Frontend + Backend + AI in one command
⚡ Lightning Fast - Powered by Vite and modern tooling
🔒 Type-Safe - End-to-end TypeScript with runtime validation
📱 Modern React 19 - Latest features and performance
🤖 AI-First - Built-in AI assistant and chat capabilities

Features

• ⚛️ React 19 with the newest features and performance improvements
• 🛣️ TanStack Router for type-safe, file-based routing
• ⚡ Hono OpenAPI - Ultra-fast backend with automatic API docs
• 🤖 Mastra AI integration for intelligent applications
• 🔒 End-to-end type safety with Zod schemas
• 🔄 React Query for server state management
• 🎨 Tailwind CSS for beautiful, responsive designs
• 📝 TypeScript throughout the entire stack
• 📚 Auto-generated API docs with Swagger UI
• 🔧 DevX optimized with hot reload and instant feedback

Quick Start

# Create a new project (fastest way)
npx create-tanstack-hono-start my-awesome-app

# Or with npm
npm create tanstack-hono-start my-awesome-app

# Or with yarn
yarn create tanstack-hono-start my-awesome-app

# Or with pnpm
pnpm create tanstack-hono-start my-awesome-app

Why choose this over create-react-app? Get a full-stack application with backend API, TypeScript, AI integration, and modern tooling in seconds - not hours of setup!

What's Included

Frontend (React 19 + TanStack Router)

• Modern React 19 with latest features
• Type-safe routing with TanStack Router
• Beautiful UI components with Tailwind CSS
• React Query for data fetching and caching
• Full TypeScript support

Backend (Hono + OpenAPI)

• Ultra-fast Hono web framework
• OpenAPI/Swagger documentation
• Zod schemas for runtime validation
• Type-safe API endpoints
• CORS and middleware support

AI Integration (Mastra)

• Built-in AI assistant capabilities
• Ready-to-use chat endpoints
• Context-aware responses
• Easy integration with your app logic

Generated Project Structure

my-awesome-app/
├── apps/
│   ├── web/          # React frontend
│   └── api/          # Hono backend
├── package.json      # Workspace configuration
└── README.md         # Project documentation

API Documentation

Your generated project includes:

• Swagger UI at http://localhost:8000/ui
• OpenAPI spec at http://localhost:8000/doc
• Type-safe API client with runtime validation

Development

# Start the development servers
npm run dev

# Frontend: http://localhost:3000
# Backend: http://localhost:8000
# API Docs: http://localhost:8000/ui

Available Endpoints

• GET /api/users - User management
• POST /api/users - Create users
• POST /api/ai/chat - AI assistant
• GET /api/health - Health check

Popular Use Cases

• 🏢 Enterprise Apps - Full-stack apps with type safety
• 🛒 E-commerce - Product catalogs with AI recommendations
• 📊 Dashboards - Analytics with real-time data
• 🤖 AI Apps - Chat interfaces and intelligent features
• 📱 SaaS Products - Multi-tenant applications
• 🎮 Interactive Apps - Real-time features and animations

Comparison

| Feature | create-react-app | Vite | create-tanstack-hono-start | |---------|------------------|------|-----------------------------| | Setup Time | 5-10 min | 2-5 min | 30 seconds | | Backend Included | ❌ | ❌ | ✅ Full API | | TypeScript Setup | Manual | Manual | ✅ Pre-configured | | AI Integration | ❌ | ❌ | ✅ Built-in | | API Documentation | ❌ | ❌ | ✅ Auto-generated | | Type-Safe Routing | ❌ | ❌ | ✅ TanStack Router |

Contributing

We welcome contributions! Please see our Contributing Guide.

License

MIT © create-tanstack-hono-start

⭐ If this helps you build awesome apps, please star the repo! ⭐