Angular + NestJS User Management

A monorepo demonstrating user management with Angular frontend, NestJS backend, Better Auth authentication, and PostgreSQL database.

Prerequisites

• Bun (v1.0+)
• Docker (for PostgreSQL)
• Hurl (optional, for API integration tests)

Setup

1. Start PostgreSQL

Make sure Docker is running, then start the database:

bun run db:up

2. Install dependencies

bun install

3. Set up environment variables

Copy the example environment file in the API package:

cp packages/api/.env.example packages/api/.env

Edit packages/api/.env with your configuration (the defaults work for local development).

4. Initialize the database

Run migrations and seed the database with test users:

bun -C packages/api db:reset
bun -C packages/api db:seed

5. Start development servers

Run both the API and UI in development mode:

bun run dev

Or run them separately:

# Terminal 1 - API (runs on http://localhost:3000)
bun -C packages/api dev

# Terminal 2 - UI (runs on http://localhost:4200)
bun -C packages/ui dev

Seeded Users

After running the seed command, you can log in with:

Available Scripts

Root

API (packages/api)

UI (packages/ui)

Running Tests

API Integration Tests (Hurl)

The API has integration tests written in Hurl. Install Hurl first:

# macOS
brew install hurl

# Or see https://hurl.dev/docs/installation.html for other platforms

Then run the tests (with the API server running):

bun -C packages/api hurl

Project Structure

angular-user-mgmt/
├── packages/
│   ├── api/          # NestJS backend
│   │   ├── prisma/   # Database schema and migrations
│   │   ├── src/      # Source code
│   │   └── tests/    # Hurl integration tests
│   └── ui/           # Angular frontend
│       └── src/      # Source code
├── docker-compose.yml
└── biome.json

Tech Stack

• Frontend: Angular 20, PrimeNG, NgRx
• Backend: NestJS, GraphQL Yoga, Prisma
• Auth: Better Auth (email/password, sessions)
• Database: PostgreSQL
• Email: Resend + React Email