Bookra

Remote-first booking SaaS scaffold aligned to the tdvorak-fullstack profile with these overrides:

• frontend on Vercel
• backend on Railway
• Neon Postgres + Neon Auth
• Paddle billing
• no Docker-based local runtime

Workspace

• apps/frontend SolidJS frontend
• apps/backend Go API
• apps/auth-service auth + internal admin service
• packages/api-client generated TypeScript client/types from OpenAPI
• packages/shared-types shared frontend constants and helpers

Local development

Frontend

npm install
npm run dev:frontend

Backend

cd apps/backend
go run ./cmd/api

Both apps expect remote services:

• Neon Postgres
• Neon Auth
• Paddle

Optional extra service:

• apps/auth-service for standalone auth/admin workflows

See .env.example, apps/frontend/.env.example, and apps/backend/.env.example.

CI/CD

• GitHub Actions CI lives in .github/workflows/ci.yml
• rollout notes and platform wiring live in docs/ci-cd.md

Backend database commands

npm run db:generate
npm run db:migrate:status
npm run db:migrate:up

db:migrate:* expects BOOKRA_DATABASE_DIRECT_URL to be exported in the shell.