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.

Logging

Logging setup out of the box

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".



About ​

This is all about creating a simple boilerplate to hit the ground running. The project will lean on Bun as much as possible through out the development processto keep the project light and easy to maintain.

Currently a static frontend and a Hono API are included.

Some DB work is coming but not yet implemented.

Roadmap ​

  • Unit tests
  • E2E playwright tests
  • Attach postgres db
  • Attach redis cache
  • Frontend Auth
    • Attaching auth headers
    • Auth hook
      • get auth state
      • get token/user info
    • Protected routes
    • Auth actions
      • sign in
      • sign up
      • etc...
  • Backend Auth
    • Middleware for protected routes
    • Attach user id to request logger
    • oauth support
    • email otp support
    • sms otp support ? who knows ?
  • Email sending API
  • Github actions
    • Automated PR tests check