fullstack-bun

Minimal, performant, type-safe monorepo project template. Bun/Elysia backend, React frontend, Socket.IO bridging the gap.

Features

• Scalar documentation for API routes is served on /reference. OpenAPI Specification raw .json data is served on /reference/json.

• The client implements PWA standards for a native app-like experience and boasts a near-perfect PageSpeed Insights score out of the box. It instantly rebuilds in dev mode when a client-side source file is saved, and the browser will automatically refresh, optionally with persisted state via the usePersistedState hook.

• Includes a Dockerfile, fly.toml, and GitHub workflow for deploying to fly.io on pushes to the main branch.

Setup

1. Install Bun
2. Install package dependencies: bun i
3. Start app in dev mode: bun dev
4. The client will be served on localhost:3000 unless overridden in a .env file (see .env.example for all environment variable options)

Stack

• Bun - server runtime, bundler, package manager, script runner
• Elysia - web framework
• React - user interface
• TanStack Query - async state management
• Socket.IO - real-time server/client communication
• TypeScript, ESLint, Prettier - code quality/style