Instalação

Pré-requisitos

• Bun 1.3+
• Node 22+ (apenas para ferramentas que ainda não suportam Bun)
• PostgreSQL 15+ (local ou Docker)
• Git

Clone & install

git clone <your-repo> my-saas
cd my-saas
bun install

Variáveis de ambiente

cp apps/server/.env.example apps/server/.env

Edite apps/server/.env:

• DATABASE_URL — connection string do Postgres
• BETTER_AUTH_SECRET — gere um com openssl rand -base64 32
• BETTER_AUTH_URL — http://localhost:3005 em dev

Database

cd apps/server
bunx prisma migrate dev
bunx prisma generate

Run

# a partir da raiz
bun run dev

• Client: http://localhost:3004
• Server: http://localhost:3005
• Docs: http://localhost:3004/docs

Serviços de desenvolvimento (Docker)

O stack de desenvolvimento inclui Postgres, Redis e MailHog (armadilha SMTP para testes E2E):

docker compose -f docker-compose.dev.yml up -d

MailHog captura todos os emails enviados. Web UI: http://localhost:8025. Para rotear o servidor por ele, defina SMTP_HOST=localhost e SMTP_PORT=1025 em apps/server/.env.

Troubleshooting

@prisma/client did not initialize — execute bunx prisma generate a partir de apps/server/.

O servidor quebra com Invalid environment — o .env não existe ou está faltando vars obrigatórias.