🚀 TanStack Hono Start

⚡ The fastest way to bootstrap modern fullstack applications with React 19, TanStack Router, Hono OpenAPI, and Mastra AI

🎬 Quick Demo

Create a modern fullstack app in seconds with React 19, TanStack Router, Hono OpenAPI, and AI integration!

✨ Features

• 🎯 Type-Safe: End-to-end TypeScript from frontend to backend
• ⚡ Lightning Fast: Powered by Vite and Hono for optimal performance
• 🧪 Test Ready: Vitest setup with modern testing practices
• 🎨 Beautiful: Tailwind CSS with responsive design
• 🔧 Developer Experience: Hot reloading, ESLint, Prettier
• 🚀 Production Ready: CI/CD with GitHub Actions, Docker support
• 📦 Monorepo: Clean workspace organization

🚀 Quick Start

# Create a new project (recommended)
npx create-tanstack-hono-start@latest my-awesome-app

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

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

🎯 What's New in 2025

• 🆕 React 19 - Latest React with improved performance and features
• 🔗 Hono OpenAPI - Auto-generated API documentation with Swagger UI
• 🤖 Mastra AI - Built-in AI assistant capabilities
• 🔒 End-to-End Type Safety - Shared Zod schemas between frontend/backend
• ⚡ React Query - Advanced server state management
• 🎨 Modern UI - Beautiful Tailwind components out of the box

🎯 What You Get

Frontend (React 19 + TanStack Router)

• ⚛️ React 19 - Latest features and performance improvements
• 🛣️ TanStack Router - Type-safe routing with file-based structure
• ⚡ Vite - Lightning-fast development and build
• 🎨 Tailwind CSS - Beautiful, responsive UI components
• 🔄 React Query - Advanced data fetching and caching
• 🧪 Vitest - Modern testing framework

Backend (Hono + OpenAPI)

• 🔥 Hono - Ultra-fast web framework
• 📚 OpenAPI/Swagger - Auto-generated API documentation
• 🛡️ Zod Schemas - Runtime validation and type safety
• 🤖 Mastra AI - Built-in AI assistant endpoints
• 🔍 Logging & Error Handling - Production-ready setup
• 📝 Full TypeScript - End-to-end type safety

Generated API Endpoints

• GET /api/users - User management with type validation
• POST /api/users - Create users with Zod schema validation
• POST /api/ai/chat - AI assistant with Mastra integration
• GET /ui - Interactive Swagger UI documentation
• GET /doc - OpenAPI JSON specification

🛠️ Available Templates

• basic - Essential fullstack setup with React + Hono
• advanced - Includes auth, database, and testing (coming soon)

📋 CLI Options

# Interactive mode (recommended)
npx create-tanstack-hono-start

# Skip prompts with defaults
npx create-tanstack-hono-start my-app --yes

# Specify template
npx create-tanstack-hono-start my-app --template basic

# List available templates
npx create-tanstack-hono-start list

🏗️ Generated Project Structure

When you run npx create-tanstack-hono-start my-app, you'll get:

my-app/                   # ← Your new project
├── apps/
│   ├── web/             # React app with TanStack Router
│   └── api/             # Hono API server
├── packages/            # Shared packages
├── package.json         # Workspace configuration
└── README.md

🛠️ Usage

# Interactive mode
npx create-tanstack-hono-start

# Specify project name
npx create-tanstack-hono-start my-project

# Choose template (coming soon)
npx create-tanstack-hono-start my-project --template advanced

🤝 Why TanStack Router + Hono?

• 🔥 Performance: Hono is one of the fastest web frameworks
• 🔒 Type Safety: End-to-end TypeScript support
• 🎯 Developer Experience: Excellent tooling and debugging
• 🌐 Edge Ready: Deploy anywhere with minimal configuration
• 📱 Modern: Built for the latest web standards

🧪 Tech Stack

Frontend (Web App)

• React - UI library
• TanStack Router - Type-safe routing
• TypeScript - Type safety
• Vite - Build tool

Backend (API)

• Hono - Web framework
• TypeScript - Type safety
• Node.js - Runtime

📖 Documentation

• TanStack Router Docs
• Hono Documentation
• Getting Started Guide
• API Reference

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

# Clone the repository
git clone https://github.com/yourusername/tanstack-hono-starter.git

# Install dependencies
cd tanstack-hono-starter
npm install

# Start development
npm run dev

📄 License

MIT License - see the LICENSE file for details.

🌟 Show Your Support

If this project helped you, please consider giving it a ⭐ on GitHub!

🔗 Links

• GitHub Repository
• npm Package
• Issues & Bug Reports

---

Happy coding! 🎉 Built with ❤️ for the modern web development community.