Open-source HRIS (Human Resource Information System) built with Next.js 15, TypeScript, Prisma, and PostgreSQL. Designed for small and mid-sized companies to manage employees, absences, documents, equipment, benefits, and more.
DutyDuke is a self-hosted HR management platform following Clean Architecture principles. It provides a complete suite of HR tools — from employee onboarding and leave management to document tracking and performance feedback — all within a single deployable application.
- Employee Management — profiles, onboarding, employment history, skills, education
- Absence Management — leave requests, approval workflows, availability calendar, iCal export
- Document Management — upload, categorize, track expiration dates, assign to employees or company
- Equipment Tracking — inventory, assignments, changelog, status management
- Benefits Administration — create benefit plans, assign to employees
- Performance Feedback — schedule and track feedback sessions
- Role-Based Access Control — granular permissions per resource and action (VIEW, CREATE, EDIT, DELETE, ASSIGN, EXPORT)
- CV Generation — export employee profiles as PDF
- Multi-language Support — English and Polish out of the box (extensible via next-intl)
- Field-Level Encryption — sensitive data encrypted at the database level
- Email Notifications — account invitations, password resets (Mailcatcher for development)
 |
 |
 |
 |
| Login | Dashboard | Documents | Employee Profile |
 |
 |
 |
 |
| Employee Absence | Salary | Availability | Roles |
Click any screenshot to view full size.
- Node.js (see
.nvmrcfor version) - Yarn
- Docker & Docker Compose
# 1. Clone and install
git clone https://github.com/Bitnoise/dutyduke.git
cd dutyduke
yarn install
# 2. Configure environment
cp .env.dist .env
# Edit .env and set required values:
# PRISMA_FIELD_ENCRYPTION_KEY — generate at https://cloak.47ng.com/
# JWT_SECRET — generate with: node -e "console.log(require('crypto').randomBytes(128).toString('hex'))"
# 3. Start database
docker compose up -d
# 4. Setup database
yarn prisma:generate
yarn prisma:migrate
yarn prisma:seed
# 5. Create your admin account
yarn create:owner admin@example.com YourPassword123 John Doe
# 6. Create your organization
yarn organization:create MyOrganizationName
# 7. Start the app
yarn devOpen http://localhost:3000 and sign in with your admin credentials.
| Layer | Technology |
|---|---|
| Framework | Next.js 15 (App Router), React 18, TypeScript |
| Database | PostgreSQL 16 with PostGIS |
| ORM | Prisma 5 with field-level encryption |
| Auth | JWT with role-based access control |
| UI | Tailwind CSS, React Aria Components |
| Validation | Zod |
| Nodemailer (Mailcatcher for dev) | |
| Logging | Pino |
| Architecture | Clean Architecture, Repository Pattern, Use Case Pattern |
| Containerization | Docker, Docker Compose |
dutyduke/
├── src/
│ ├── api/hris/ # Backend API (Clean Architecture)
│ │ ├── prisma/ # Schema, migrations, seed
│ │ ├── authentication/ # Auth domain
│ │ ├── authorization/ # RBAC & permissions
│ │ ├── employees/ # Employee management
│ │ ├── company/ # Company settings
│ │ ├── absences/ # Leave management
│ │ ├── benefits/ # Employee benefits
│ │ ├── documents/ # Document management
│ │ ├── feedback/ # Performance feedback
│ │ ├── resources/ # Skills, equipment, etc.
│ │ └── settings/ # Application settings
│ │
│ ├── app/ # Next.js App Router
│ │ ├── (auth)/ # Sign-in, password recovery
│ │ ├── (hris)/ # Protected HR routes
│ │ └── api/ # API routes
│ │
│ ├── lib/ui/ # Reusable UI components
│ │
│ └── shared/ # Constants, types, utils, services
│
├── messages/ # i18n translations (en, pl)
├── docker-compose.yml # PostgreSQL + Mailcatcher
├── Dockerfile # Production build
└── package.json
Each domain in src/api/hris/ follows Clean Architecture:
- Model (
model/) — DTOs, repository interfaces, use cases - Infrastructure (
infrastructure/) — Prisma repositories, controllers, ACLs, queries
| Command | Description |
|---|---|
yarn dev |
Start development server |
yarn build |
Build for production |
yarn start |
Start production server |
yarn lint |
Run ESLint + TypeScript check |
yarn fix |
Auto-fix lint issues |
| Command | Description |
|---|---|
yarn prisma:generate |
Generate Prisma client |
yarn prisma:migrate |
Create and run migration |
yarn prisma:migrate:deploy |
Apply migrations (production) |
yarn prisma:reset |
Reset database (deletes all data) |
yarn prisma:studio |
Open Prisma Studio GUI |
yarn prisma:seed |
Seed default organization and roles |
| Command | Description |
|---|---|
yarn create:owner <email> <password> <firstName> <lastName> |
Create admin user with OWNER role |
yarn promote:owner <email> |
Promote existing user to OWNER |
yarn change:password <email> <newPassword> |
Reset a user's password |
| Command | Description |
|---|---|
yarn fixtures:load |
Load demo fixture data |
yarn fixtures:clean |
Remove and reload fixtures |
| Command | Description |
|---|---|
yarn nuke |
Clean install (removes .next, node_modules, reinstalls) |
See .env.dist for all options. Key variables:
| Variable | Required | Description |
|---|---|---|
DATABASE_URL |
Yes | PostgreSQL connection string |
PRISMA_FIELD_ENCRYPTION_KEY |
Yes | Encryption key (generate here) |
JWT_SECRET |
Yes | Secret for JWT signing |
NEXT_PUBLIC_APP_URL |
Yes | Application URL (e.g., http://localhost:3000) |
ORGANIZATION_NAME |
No | Company name (default: "DutyDuke") |
NEXT_PUBLIC_THEME |
No | UI theme: hris (default) or your own custom theme |
NEXT_PUBLIC_DEFAULT_LANGUAGE |
No | Default locale: en or pl |
When running with Docker Compose:
| Service | URL |
|---|---|
| Application | http://localhost:3000 |
| Mailcatcher UI | http://localhost:1080 |
| PostgreSQL | localhost:5432 |
| Prisma Studio | yarn prisma:studio |
- Getting Started — Installation, Configuration
- Architecture — Overview, RBAC
- Guides — Deployment, User Management
- Development — Project Structure, Coding Standards
See CONTRIBUTING.md for development setup, code style, and pull request guidelines.
MIT License - Copyright (c) 2024-2026 Bitnoise
See LICENSE for details.