Repository files navigation

Building modern web applications shouldn't require weeks of configuration hell. This React Starter Kit eliminates the tedious setup work so you can focus on what matters: shipping great products.

Designed for developers who value both speed and quality, this template provides a complete foundation for full-stack applications. From solo projects to team collaborations, it scales with your ambitions while maintaining the developer experience you deserve.

• Performance by Default: Bun runtime delivers exceptional speed across development and production. Your build times will thank you.
• Type Safety Throughout: TypeScript and tRPC create an unbreakable contract between frontend and backend. Catch errors at compile time, not in production.
• Modern React Stack: React 19 with TanStack Router provides type-safe navigation and powerful data fetching patterns. Tailwind CSS v4 handles styling with zero configuration.
• Edge-Native Deployment: Cloudflare Workers ensure your app runs close to users worldwide. Experience sub-100ms response times globally.
• Database Ready: Drizzle ORM with Neon PostgreSQL provides a complete data layer. Multi-tenant support included out of the box.
• Developer Experience: ESLint, Prettier, and VSCode configurations eliminate bikeshedding. Focus on features, not formatting.

This project was bootstrapped withReact Starter Kit.Be sure to join ourDiscord channel for assistance.

This starter kit uses a thoughtfully organized monorepo structure that promotes code reuse and maintainability:

• apps/web/ — React frontend with Vite, TanStack Router, and Tailwind CSS
• apps/api/ — tRPC API server powered by Hono framework
• apps/edge/ — Cloudflare Workers entry point for edge deployment
• packages/core/ — Shared TypeScript types and utilities
• packages/ws-protocol/ — WebSocket protocol template with type-safe messaging
• db/ — Database schemas, migrations, and seed data
• docs/ — VitePress documentation site
• infra/ — Terraform infrastructure configurations for multi-environment deployment
• scripts/ — Build automation and development tools
• apps/web/scripts/ — ShadCN UI component management utilities

Why Monorepo? This structure enables seamless code sharing between frontend and backend, ensures type consistency across your entire stack, and simplifies dependency management. When you update a type definition, both client and server stay in sync automatically.

Deployment Flexibility: The API is deployed to Cloudflare Workers (viaapps/edge/) for global edge computing, ensuring optimal performance worldwide.

• SaaS Applications: Multi-tenant architecture with user management built-in
• API-First Products: tRPC provides excellent developer experience for API development
• Global Applications: Edge deployment ensures fast loading times worldwide
• Team Projects: Monorepo structure scales well with multiple developers
• Rapid Prototyping: Skip configuration and start building features immediately

Core Runtime & Platform

• Bun — Lightning-fast JavaScript runtime and package manager
• Cloudflare Workers — Edge computing platform

Frontend & UI

• React 19 — Latest React with concurrent features
• TanStack Router — Type-safe routing with data loading
• Tailwind CSS v4 — Utility-first CSS framework
• ShadCN UI — Beautiful, accessible components
• Jotai — Atomic state management

Backend & API

• Hono — Ultrafast web framework for the edge
• tRPC — End-to-end type safety for APIs
• Better Auth — Modern authentication solution

Database & ORM

• Drizzle ORM — TypeScript ORM with excellent DX
• Neon PostgreSQL — Serverless PostgreSQL database

Development Tools

• Vite — Next-generation frontend tooling
• Vitest — Blazing fast unit testing
• TypeScript — Static type checking
• ESLint &Prettier — Code quality and formatting

• Bun v1.2+ (replaces Node.js and npm)
• VS Code with ourrecommended extensions
• React Developer Tools browser extension (recommended)
• Cloudflare account for deployment

Generate a new repository from this template, then clone it locally:

git clone https://github.com/your-username/your-project-name.gitcd your-project-name

bun install

Update environment variables in.env and.env.local files as well as Wrangler configuration inwrangler.jsonc.

Open two terminals and run these commands:

Terminal 1 - Frontend:

bun --filter @repo/web dev

Terminal 2 - Backend:

bun --filter @repo/edge build --watchbun wrangler dev

# Apply database schema and migrationsbun --filter @repo/db migratebun --filter @repo/db seed# Optional: add sample data

Openhttp://localhost:5173 to see your app running. The backend API will be available at the port shown bywrangler dev (typically 8787).

Ensure your production environment variables are configured:

# Set secrets in Cloudflare Workersbun wrangler secret put BETTER_AUTH_SECRET --env=productionbun wrangler secret put OPENAI_API_KEY --env=production

# Build all packagesbun --filter @repo/web buildbun --filter @repo/edge build# Deploy to Cloudflare Workersbun wrangler deploy --env=production

Your application will be live on your Cloudflare Workers domain within seconds. The edge-first architecture ensures optimal performance regardless of user location.

• GraphQL API and Relay Starter Kit — monorepo template, pre-configured with GraphQL API, React, and Relay
• Cloudflare Workers Starter Kit — TypeScript project template for Cloudflare Workers
• Node.js API Starter Kit — project template, pre-configured with Node.js, GraphQL, and PostgreSQL

Anyone and everyone is welcome tocontribute. Startby checking out the list ofopen issuesmarkedhelp wanted.However, if you decide to get involved, please take a moment to review theguidelines.

Copyright © 2014-present Kriasoft. This source code is licensed under the MIT license found in theLICENSE file.

^{Made with ♥ by Konstantin Tarkus (@koistya,blog)andcontributors.}