Nexus HR

An enterprise-grade, intelligent human resource management platform built with Next.js 15.

Modules

Nexus HR is organized into interconnected modules covering the full employee lifecycle:

Module	Description
Core HR	Employee directory, org chart, profile management
Recruitment	Job postings, candidate pipeline, applicant tracking
Onboarding	Task checklists, progress tracking, template-driven flows
Attendance	Clock-in/out, timesheets, time entry management
Leave	PTO requests, leave balances, approval calendar
Payroll	Compensation summaries, payroll runs, deductions
Performance	Review cycles (360, peer, annual), feedback, ratings
Training	Course catalog, enrollments, skills matrix
Compliance	Audit logs, regulation tracking (FMLA, EEOC, GDPR), evidence management
Org Analytics	Diversity metrics, span-of-control analysis, headcount heatmaps

Tech Stack

• Framework: Next.js 15 (App Router)
• Language: TypeScript
• Database: SQLite via Prisma ORM
• Auth: NextAuth.js v5 (Prisma adapter)
• State: Zustand (client) + TanStack Query (server)
• UI: Radix UI primitives, Tailwind CSS, Lucide icons, Recharts
• Styling: CSS variables, CVA, clsx + tailwind-merge

Getting Started

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Create/migrate the database
npm run db:push

# Seed the database (phase 3 modules)
npm run db:seed:phase3

# Start development server
npm run dev

Database Commands

npm run db:generate    # Regenerate Prisma client
npm run db:push        # Push schema changes to SQLite
npm run db:seed        # Seed phase 1 & 2 data
npm run db:seed:phase3 # Seed compliance, training, performance data
npm run db:studio      # Open Prisma Studio (browser GUI)

Project Structure

src/
├── app/
│   ├── (auth)/login/          # Login page
│   ├── (dashboard)/          # All authenticated routes
│   │   ├── employees/
│   │   ├── organization/
│   │   ├── attendance/
│   │   ├── leave/
│   │   ├── payroll/
│   │   ├── performance/
│   │   ├── recruitment/
│   │   ├── training/
│   │   ├── onboarding/
│   │   └── compliance/
│   └── api/auth/             # NextAuth API routes
├── components/
│   ├── layouts/              # Shell, sidebar, topbar
│   ├── modules/              # Feature-specific components
│   │   ├── core-hr/
│   │   ├── attendance/
│   │   ├── leave/
│   │   ├── payroll/
│   │   ├── performance/
│   │   ├── recruitment/
│   │   ├── onboarding/
│   │   ├── compliance/
│   │   └── org-analytics/
│   └── ui/                    # Shared UI primitives
├── lib/
│   ├── actions/               # Server actions per module
│   ├── auth/                  # NextAuth config
│   ├── db/                    # Prisma client + seed
│   └── rules/                 # Domain rules
├── stores/                    # Zustand stores
└── types/                    # Shared TypeScript types

Design

See docs/superpowers/specs/2026-04-12-nexus-hr-design.md for the full design specification.