🔥 Hono React Router

Hono React Router is a production-ready template designed to launch your web app seamlessly on Cloudflare Workers.
It builds upon the official React Router Cloudflare D1 template, offering a more powerful and flexible foundation.

📖 Explore the Hono and React Router documentation for full feature references.

---

Demo: https://hono-react-router.zett.workers.dev

🚀 Available Setups

This repository also includes a lighter version under the mini branch — choose the version that best fits your needs.

Feature / Branch	main	mini
Hono Server	✅	✅
└─ Clean Architecture	✅
React Router (Framework mode)	✅	✅
D1 Database	✅
Authentication (Clerk)	✅
Drizzle ORM	✅
Testing (Vitest)	✅
Zod Validation	✅
Tailwind CSS	✅	✅
Prettier	✅	✅
ESLint (Flat Config)	✅	✅
Vite	✅	✅
TypeScript	✅	✅

🛠️ Getting Started

1. Install dependencies

pnpm install

2. Generate types

pnpm typegen

3. Run initial database migration

pnpm db:generate
pnpm db:migrate

4. Start the development server (with HMR)

pnpm dev

Your app will be available at: http://localhost:5173

Optional: Run with Wrangler

pnpm build
pnpm start

🏗 Building for Production

To create a production-ready build:

pnpm run build

🚢 Deployment

Deployment is handled via Wrangler.

Deploy to production:

npx wrangler deploy

Deploy a preview version:

npx wrangler versions upload

Once validated, you can promote a version to production:

npx wrangler versions deploy

🎨 Styling

This template comes pre-configured with Tailwind CSS for rapid styling. Feel free to replace or extend it with your preferred CSS framework or methodology.