Loan Review Practice

Project Overview

Loan Review Practice is a lightweight full-stack TypeScript app for live-coding interview prep. It includes a seeded in-memory loan review dashboard, list/detail workflow, status updates, note creation, and a small lint/test/typecheck layer built with ESLint and Vitest.

Repo Structure

• client/ React + Vite frontend
• server/ Express backend with in-memory application data, run via tsx
• docs/ interview exercise prompts and facilitator notes
• eslint.config.mjs shared flat ESLint config

Setup

Install dependencies from the repo root:

npm install

Start both apps from the repo root:

npm run dev

Default URLs:

• Client: http://localhost:5173
• Server health: http://localhost:3001/api/health

If 3001 or 5173 are already in use, use override ports:

PORT=4101 CLIENT_PORT=4173 API_TARGET=http://127.0.0.1:4101 npm run dev

Available Scripts

• npm run dev starts the backend and frontend together
• npm run dev:server starts only the Express server with tsx watch
• npm run dev:client starts only the Vite client
• npm run lint runs ESLint across the repo
• npm run test runs backend and frontend tests
• npm run build builds the frontend
• npm run typecheck runs the frontend and backend TypeScript checks
• npm run check runs the full repo gate: lint, tests, frontend build, and workspace typechecks

Known Tradeoffs

• Application data is stored in memory and resets on server restart.
• Search and filtering stay client-side because the dataset is intentionally small.
• The test suite is intentionally compact and focused on high-value behavior instead of exhaustive coverage.
• The note author is fixed on the server to keep the feature set interview-sized.
• The backend uses tsx at runtime rather than a compiled server build to keep the repo simple for interview prep.