Fullstack Bun

• Vite
• TypeScript
• React 19
• TailwindCSS 4
• Shadcn
• Biome
• Pino
• Hono

Get Started

PLEASE SEE https://fullstackbun.dev/get-started/

VS Code DevContainer (Recommended)

The fastest way to get started is with VS Code DevContainers:

1. Install VS Code, Docker Desktop, and the Dev Containers extension
2. Open this project in VS Code
3. Click "Reopen in Container" when prompted
4. Wait for setup to complete (5-10 minutes first time)
5. Run bun run dev to start all services

See .devcontainer/README.md for detailed documentation.

Local Development

A highly abbreviated version of the instructions is below:

• from the root directory bun install
• Run bun run setup to:
  • copy the environment files from .env.example to .env in both the API and frontend directories
• then bun run dev

Commands

To install a package, cd into the package directory and run bun install.

Do not install packages at the root level, with few exceptions.

To run the frontend and backend apps, bun run dev from the root level.

Docker

This monorepo supports containerized development and production deployment with Docker.

Quick Start:

# Development
bun run docker:dev:build

# Production
bun run docker:prod:build

For complete Docker documentation, see apps/docs/docker.md.