BookTracker Backend#

NestJS backend API for BookTracker, using Drizzle ORM with PostgreSQL.

Getting Started#

Prerequisites#

• Node.js 24.11.0
• PostgreSQL 16+

Setup#

1. Install dependencies (from root):

   pnpm install
   

2. Set up environment variables:

   cp .env.example .env
   # Edit .env with your database credentials
   

3. Run migrations:

   pnpm db:migrate
   

Development#

# Run dev server
pnpm start:dev

# Run tests
pnpm test

# Run e2e tests
pnpm test:e2e

# Lint
pnpm lint

# Format
pnpm format

Database#

# Generate migrations from schema changes
pnpm db:generate

# Run migrations
pnpm db:migrate

# Open Drizzle Studio (database GUI)
pnpm db:studio

Docker#

# Build image
docker build -t booktracker-backend .

# Run container
docker run -p 3001:3001 \
  -e DATABASE_URL=postgresql://user:pass@host:5432/booktracker \
  booktracker-backend

Or use docker-compose from the root:

docker-compose up backend

API Endpoints#

• GET / - Health check
• More endpoints to be documented...

Tech Stack#

• Framework: NestJS 11
• ORM: Drizzle ORM
• Database: PostgreSQL
• Language: TypeScript