AI-powered, mood-matched playlists for books being read.
See docs/specs/2026-07-24-underscore-mvp-design.md (MVP PRD) and
docs/specs/2026-07-24-underscore-api-design.md (API reference) for the full design.
- Monorepo via bun workspaces:
/app(Expo/React Native),/server(Express + TS),/packages/shared(zod schemas/types shared across both) - Postgres + Prisma
- Better Auth for multi-provider login; Spotify integration is a separate connector (app-level client-credentials for catalog search, user-level OAuth for playback only)
- Claude (Anthropic) for mood/genre analysis and track suggestions
- Google Books API for book metadata
- Railway for hosting
- Bun
- Postgres 16 — either a local install or the bundled Docker service
Homebrew (macOS):
brew install postgresql@16
brew services start postgresql@16
# one-time: create the role and database the app expects
createuser -s underscore
psql -d postgres -c "ALTER ROLE underscore WITH PASSWORD 'underscore';"
createdb -O underscore underscoreDocker (only if you'd rather not install Postgres locally — requires Docker Desktop):
docker compose up -d # older Docker installs use: docker-compose up -dEither way the app connects on localhost:5432 with the DATABASE_URL in
server/.env.example. Check it's up with:
psql "postgresql://underscore:underscore@localhost:5432/underscore" -c '\conninfo'bun install
# server
cp server/.env.example server/.env # fill in secrets
bun run --filter server prisma migrate dev
# app
cp app/.env.example app/.env.localbun run dev # API + Expo, opening the iOS Simulator
bun run dev:server # Express API on :3000
bun run dev:ios # Expo dev server, opening the iOS Simulator
bun run dev:app # Expo dev server onlyWith dev:app, press i for iOS Simulator, a for Android emulator, or scan the
QR code with Expo Go.
bun run dev— start the API and the app in the iOS Simulator concurrentlybun run dev:server— start the API serverbun run dev:ios— start the Expo dev server and open the iOS Simulatorbun run dev:app— start the Expo dev serverbun run lint— lint all workspacesbun run typecheck— typecheck all workspaces