Demo App — React + NestJS Coding Challenge

Monorepo with a React frontend and NestJS backend connected to PostgreSQL.

Prerequisites

• Node.js 20+
• Docker & Docker Compose

Quick Start

# 1. Start Postgres
docker compose up -d

# 2. Start backend (port 3000)
cd backend
npm install
npm run start:dev

# 3. Start frontend (port 5173) — in a separate terminal
cd frontend
npm install
npm run dev

Stack

Layer	Tech
Frontend	React 19, Vite, Redux Toolkit, shadcn/ui
Backend	NestJS 11, TypeORM, PostgreSQL 17
Database	Postgres via docker-compose.yml

Project Structure

├── AGENTS.MD              # Agent instructions
├── docker-compose.yml     # Postgres 17
├── docs/                  # Subsystem documentation
│   ├── architecture.md
│   ├── backend.md
│   └── frontend.md
├── backend/               # NestJS + TypeORM
│   ├── src/
│   └── .env
└── frontend/              # React + Vite
    └── src/
        ├── components/ui/ # shadcn/ui components
        ├── features/      # Feature modules (slice + components)
        ├── lib/           # Utilities
        └── store.ts       # Redux store

Adding a shadcn/ui Component

cd frontend
npx shadcn@latest add <component-name>