Skip to main content

​
Prerequisites

Everything from the free quickstart applies, plus:
RequirementMinimum VersionPurpose
Bun1.1.0+Runtime and package manager
Redis7.0+Queues and caching
Node.js18+TanStack Start dev server
TanStack Start currently uses Vinxi under the hood, which requires Node.js for the dev server. Bun handles the API and all package management.

​
Setup

1

Clone the repository

git clone [email protected]:mayhemds/bunship-pro.git my-saas
cd my-saas
2

Install dependencies

bun install
This installs all workspace packages: API, frontend, database, emails, UI components, and shared utilities.
3

Configure environment

cp .env.example .env
Open .env and set your keys. At minimum for local development:
# Required
JWT_SECRET=your-secret-at-least-32-characters-long
JWT_REFRESH_SECRET=another-secret-at-least-32-characters

# Optional for local dev (defaults work)
TURSO_DATABASE_URL=file:local.db
See the free installation guide for full environment variable documentation.
4

Run database migrations

bun run db:migrate
5

Seed demo data (optional)

bun run db:seed
Creates a demo user ([email protected] / demo123456) with an organization and sample data.
6

Start development

bun dev
This starts both services:

​
Verify It Works

  1. Open http://localhost:3001 — you should see the login page
  2. If you ran the seed, log in with [email protected] / demo123456
  3. You should land on the dashboard with sample data

​
Project Structure

bunship-pro/
├── apps/
│   ├── api/          # Elysia backend (same as free version)
│   └── web/          # TanStack Start + React frontend
├── packages/
│   ├── config/       # Shared configuration
│   ├── database/     # Drizzle schema & migrations
│   ├── eden/         # Type-safe API client
│   ├── emails/       # Email templates
│   ├── ui/           # shadcn/ui component library
│   └── utils/        # Shared utilities
└── package.json      # Workspace root

​
Next Steps

  • Theming — Customize colors, fonts, and dark/light mode
  • Adding Pages — Add new routes to the frontend
  • Deployment — Deploy both API and frontend