Dimension-47/.planning/codebase/STACK.md

# Technology Stack

**Analysis Date:** 2026-04-27

## Languages

**Primary:**
- TypeScript 5.9.3 (server), 5.7.3 (client) - Strict mode enabled, full type safety across codebase

**Secondary:**
- JavaScript (build outputs, scripts)
- HTML/CSS (frontend templates)

## Runtime

**Environment:**
- Node.js (version not pinned, assumed LTS) - Used for both server and client dev/build
- ES2023 target (server), ES2022 target (client)

**Package Manager:**
- npm - Lockfiles present for both client and server

## Frameworks

**Core Frontend:**
- React 19.2.0 - UI framework
- React Router DOM 7.12.0 - Client-side routing
- Vite 7.2.4 - Build tool and dev server

**Core Backend:**
- NestJS 11.0.1 - Web framework with TypeScript-first design
- Express (via `@nestjs/platform-express`) - Underlying HTTP server

**Frontend Styling:**
- Tailwind CSS 4.1.18 - Utility-first CSS framework
- `@tailwindcss/vite` plugin for Vite integration

**Testing & Development:**
- Jest 30.0.0 - Test runner (server-side only, configured in package.json)
- ts-jest - TypeScript support for Jest
- Supertest 7.0.0 - HTTP assertion library (server integration tests)
- @vitejs/plugin-react - React fast refresh for Vite

## Key Dependencies

**Critical Server:**
- `@prisma/client` 7.2.0 - ORM and database abstraction layer
- `prisma` 7.2.0 - CLI and schema management tool
- `@anthropic-ai/sdk` 0.71.2 - Claude API for on-demand German translations
- `socket.io` 4.8.3 - WebSocket library for real-time communication
- `@nestjs/websockets` 11.1.12 - NestJS WebSocket integration
- `@nestjs/platform-socket.io` 11.1.12 - Socket.io adapter for NestJS
- `@nestjs/jwt` 11.0.2 - JWT authentication provider
- `@nestjs/passport` 11.0.5 - Passport.js integration for authentication
- `passport-jwt` 4.0.1 - JWT strategy for Passport
- `bcrypt` 6.0.0 - Password hashing
- `class-validator` 0.14.3 - Request DTO validation
- `class-transformer` 0.5.1 - DTO transformation
- `@nestjs/swagger` 11.2.5 - OpenAPI/Swagger documentation
- `@nestjs/config` 4.0.2 - Environment configuration management
- `dotenv` 17.2.3 - .env file loading

**Critical Client:**
- `axios` 1.13.2 - HTTP client library for API requests
- `socket.io-client` 4.8.3 - WebSocket client for real-time updates
- `zustand` 5.0.10 - Client state management (auth store)
- `@tanstack/react-query` 5.90.19 - Server state and data fetching (caching, synchronization)
- `react-router-dom` 7.12.0 - Client-side routing
- `framer-motion` 12.26.2 - Animation library
- `lucide-react` 0.562.0 - Icon library (SVG icons)
- `clsx` 2.1.1 - Conditional CSS class utilities
- `tailwind-merge` 3.4.0 - Tailwind class merging utility

**Development (Backend):**
- `@nestjs/cli` 11.0.0 - NestJS code generation and project scaffolding
- `@nestjs/schematics` 11.0.0 - Code generators for NestJS
- `prettier` 3.4.2 - Code formatter
- `eslint` 9.18.0 - Linting
- `typescript-eslint` 8.20.0 - TypeScript ESLint support
- `tsx` 4.21.0 - TypeScript execution (used for seed scripts)
- `tsconfig-paths` 4.2.0 - TypeScript path alias resolution
- `ts-node` 10.9.2 - TypeScript REPL and script runner
- `ts-loader` 9.5.2 - TypeScript webpack loader

**Development (Frontend):**
- `eslint` 9.39.1 - Linting
- `typescript-eslint` 8.46.4 - TypeScript ESLint support
- `eslint-plugin-react-hooks` 7.0.1 - React Hooks linting rules
- `eslint-plugin-react-refresh` 0.4.24 - Vite React refresh linting

## Configuration

**Environment:**
- Server loads from `.env` file (see `.env.example`):
  - `DATABASE_URL` - PostgreSQL connection string
  - `JWT_SECRET` - Secret key for signing tokens
  - `JWT_EXPIRES_IN` - Token expiration time (default "7d")
  - `PORT` - Server port (default 5000)
  - `NODE_ENV` - Environment (development/production)
  - `CORS_ORIGINS` - Comma-separated list of allowed origins
  - `ANTHROPIC_API_KEY` - Claude API key for translations (optional)
  - `UPLOAD_DIR` - Directory for file uploads
  - `MAX_FILE_SIZE` - Maximum upload file size

- Client loads from `.env` or `.env.local`:
  - `VITE_API_URL` - Backend API base URL (e.g., `http://localhost:5000/api`)
  - WebSocket URL derived automatically by removing `/api` suffix

**TypeScript:**
- Server: `server/tsconfig.json` with target ES2023, decorators enabled
  - `strictNullChecks: true`
  - `forceConsistentCasingInFileNames: true`
  - `noImplicitAny: false` (allows implicit any in some cases)
  - Path aliases via `baseUrl: ./`

- Client: `client/tsconfig.app.json` with target ES2022, strict mode
  - `strict: true` - All strict options enabled
  - `noUnusedLocals: true`, `noUnusedParameters: true`
  - `jsx: react-jsx` - JSX without React import required
  - Path alias `@/*` → `./src/*`

**Build:**
- Client Vite config: `client/vite.config.ts`
  - Dev server port 5173
  - API proxy `/api` → `http://localhost:5000`
  - React plugin with React 19 support
  - Tailwind CSS Vite plugin
  - Type checking via `tsc -b` before build

- Server NestJS config: `server/nest-cli.json` (if exists)
  - Build output to `dist/`

## Platform Requirements

**Development:**
- Node.js LTS (tested with v22)
- npm (lockfiles version management)
- PostgreSQL 16+ (via Docker Compose)
- Docker & Docker Compose (for database)
- Git

**Production:**
- Node.js LTS
- PostgreSQL 16+ (managed service or self-hosted)
- Anthropic API key for translations (optional but recommended)
- File storage: Local filesystem or cloud storage (currently local via `./uploads`)

## Database

**PostgreSQL 16 Alpine** (via Docker Compose):
- Port 5432 (internal), 5433 (exposed for dev)
- Database name: `dimension47`
- Default credentials in docker-compose (dev only)
- pgAdmin 4 included for database management (port 5050)

**Prisma Configuration:**
- Schema: `server/prisma/schema.prisma`
- Generator: Prisma Client with CommonJS module format
- Adapter: `@prisma/adapter-pg` for optimized PostgreSQL queries
- Output: `src/generated/prisma/`

---

*Stack analysis: 2026-04-27*