Instalación

Prerrequisitos

• Bun 1.3+
• Node 22+ (sólo para herramientas que aún no soportan Bun)
• PostgreSQL 15+ (local o Docker)
• Git

Clone & install

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

Variables de entorno

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

Editá apps/server/.env:

• DATABASE_URL — connection string de Postgres
• BETTER_AUTH_SECRET — generá uno con openssl rand -base64 32
• BETTER_AUTH_URL — http://localhost:3005 en dev

Database

cd apps/server
bunx prisma migrate dev
bunx prisma generate

Run

# desde la raíz
bun run dev

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

Servicios de desarrollo (Docker)

El stack de desarrollo incluye Postgres, Redis y MailHog (trampa SMTP para tests E2E):

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

MailHog captura todos los emails salientes. Web UI: http://localhost:8025. Para enrutar el servidor a través de él, configurá SMTP_HOST=localhost y SMTP_PORT=1025 en apps/server/.env.

Troubleshooting

@prisma/client did not initialize — corré bunx prisma generate desde apps/server/.

El servidor crashea con Invalid environment — el .env no existe o le faltan vars requeridas.