- Initialize Next.js 15 with App Router and TypeScript strict mode - Configure Tailwind CSS with shadcn/ui theme system - Install shadcn/ui components (button, card, input, table, etc.) - Set up ESLint and Prettier with automatic formatting - Configure path aliases (@/*) in tsconfig.json - Create full project structure per CLAUDE.md - Add health check endpoint at /api/health - Configure next.config.ts with output: 'standalone' for Docker - Set up Prisma with placeholder schema - Configure Vitest (unit) and Playwright (E2E) testing - Add VS Code settings for consistent development experience Build verification: TypeScript compilation, ESLint, and production build all pass. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2 KiB
2 KiB
Vorteq Quest Portal
Modern customer portal for Vorteq Coil, built with Next.js 15, TypeScript, and PostgreSQL.
Tech Stack
- Framework: Next.js 15 with App Router
- Language: TypeScript (strict mode)
- Database (App): PostgreSQL 16 with Prisma ORM
- Database (Epicor): SQL Server (read-only via mssql package)
- Auth: Better Auth
- UI: shadcn/ui + Tailwind CSS
- Cache/Queue: Redis 7 + BullMQ
- Email: Microsoft Graph API
- Infrastructure: Docker + Traefik + Forgejo CI/CD
Getting Started
Prerequisites
- Node.js 22 LTS
- Docker & Docker Compose
- Access to Epicor SQL Server
Development Setup
-
Install dependencies:
npm install -
Set up environment variables:
cp .env.example .env # Edit .env with your configuration -
Initialize database:
npm run db:push npm run db:seed -
Run development server:
npm run dev
Available Scripts
npm run dev- Start development servernpm run build- Build for productionnpm run start- Start production servernpm run lint- Run ESLintnpm run typecheck- Run TypeScript compiler checknpm test- Run unit testsnpm run test:e2e- Run E2E testsnpm run db:push- Push Prisma schema to databasenpm run db:migrate- Create migrationnpm run db:seed- Seed database
Project Structure
See CLAUDE.md for detailed project structure and coding conventions.
Documentation
- Project Instructions:
CLAUDE.md - Task Tracking:
TASKS.md - PRD:
docs/Vorteq_Quest_PRD_v1.0.docx - Legacy Documentation:
docs/directory
Infrastructure
- Production: https://quest.vorteq.wulf.cloud
- Development: https://dev.quest.vorteq.wulf.cloud
- Testing: https://testing.vorteq.wulf.cloud
- Traefik Dashboard: https://traefik.vorteq.wulf.cloud
License
Proprietary - Vorteq Coil