Fullstack-Bun Docs

Appearance

Delicious fullstack Bun boilerplateHono + React

A simple boilerplate to hit the ground running.

Get Started
Reference

React 19 + Vite

The latest React version powered by Vite

React Router 7

Type safe routing with framework mode ready to-go

TanStack Form

Type safe form handling with TanStack Form

Internationalization

Powered by i18next and react-i18next. Just add translations and you are ready to go.

TailwindCSS 4

The latest Tailwind release

React Testing Library & MSW

The React Testing Library you love run via Bun's test runner. Oh and we have MSW for mocking APIs/intercepting requests.

Shadcn

Bring the components you love via the CLI

Hono API + Hono client setup

Fullstack type safe hono client and react-query setup

Zod validation

Use the same schema for API and frontend validation.

PostgreSQL + Drizzle ORM

Type-safe database access with Drizzle ORM and PostgreSQL 15. Migrations, schema management, and Drizzle Studio included.

better-auth Authentication

Complete authentication system with email/password, email verification, session management, and optional OAuth support (GitHub, Google).

Email Verification

Built-in email verification flow using Nodemailer with SMTP support. Development mode logs verification URLs to console.

Protected Routes

Frontend and backend route protection. ProtectedRoute component for React and authMiddleware for Hono API.

Logging

Logging setup out of the box with Pino

Traceability

Every request/session has a UUID attached to the header/logger.

Biome

Biome for linting and formatting. Easy to use, quick to run, and it "just works".

Docker Support

Full containerization for development and production with Docker Compose. Hot reload, health checks, and multi-stage builds included.

PostgreSQL + Drizzle

First-class database setup with PostgreSQL 15 and Drizzle ORM, ready for migrations and local dev.

Redis

Redis is provisioned alongside Postgres via Docker Compose for caching/session-style workloads.



About ​

This is a production-ready fullstack boilerplate designed to help you hit the ground running with modern web development.

The project leverages Bun as much as possible throughout the development process to keep things fast, light, and easy to maintain.

What's Included ​

  • Frontend: React 19 with Vite, React Router 7, TailwindCSS 4, and Shadcn UI components
  • Backend: Hono API with type-safe client integration and React Query
  • Database: PostgreSQL 15 with Drizzle ORM for type-safe database access
  • Authentication: Complete auth system using better-auth with email verification and session management
  • Internationalization: Multi-language support with i18next (English, German, Spanish, French)
  • Testing: Bun test runner with React Testing Library and MSW for API mocking
  • Docker: Full containerization for development and production environments
  • Developer Experience: Biome for linting/formatting, Pino for logging, UUID-based request tracing

Roadmap ​

Future enhancements we're considering:

  • E2E Testing: Playwright test suite for end-to-end testing
  • Advanced Auth Features:
    • Email OTP support (passwordless login)
    • SMS OTP support for two-factor authentication
    • Additional OAuth providers (Google, Discord, etc.)
  • CI/CD Pipeline:
    • GitHub Actions for automated testing on PRs
    • Automated deployments
  • Performance Monitoring: Integration with performance monitoring tools
  • Rate Limiting: API rate limiting middleware
  • File Uploads: S3-compatible file upload handling