HR and payroll

A system for employee records, contracts, leave, attendance, and payroll runs producing payslips. Tax and statutory deduction rules are regional and must be implemented for the target country.

You can change every choice once the builder opens.

Core features for the MVP

Employee records with contract, role, and salary history
Leave requests with balances, approval workflow, and a calendar
Attendance and timesheet capture, including overtime
Payroll runs producing payslips per employee per period
Statutory and voluntary deductions applied per employee
Employee self-service portal restricted to their own records
Audit trail on every change to pay or contract data

Left for later

Performance reviews and objectives
Recruitment and applicant tracking
Bank payment file export for bulk transfer
Statutory return submission to the tax authority

Recommended stack

Section	Recommended
Language	TypeScript
Frontend framework	Next.js
UI and styling	Tailwind CSSshadcn/ui
Backend	Next.js server
API style	Server actions
Database engine	PostgreSQL
Database provider	Neon
ORM and data access	Drizzle
Authentication	Clerk
Authorization and roles	Role-based access controlRow-level security
Security	Input validationRate limitingSecurity headers and CSPSecrets managementEncryption at restAudit logsTwo-factor authentication
File storage	AWS S3
Background jobs and cron	Inngest
Email and notifications	Resend
Hosting and deployment	Vercel
CI/CD	GitHub Actions
Monitoring and analytics	Sentry
Testing	VitestPlaywright
Extras	Reports and PDF exportCSV and Excel import/exportBackupsAccessibility (WCAG)Documentation

Data model draft

Employee

A person employed by the organisation.

id
employeeNumber
fullName
email
nationalIdRef
departmentId
managerId
startDate
endDate

Belongs to one Department
Has many Contracts
Has many LeaveRequests

Contract

The terms an employee is engaged on, including pay.

id
employeeId
jobTitle
contractType
baseSalaryMinorUnits
currency
effectiveFrom
effectiveTo

Belongs to one Employee

LeaveRequest

A request for time off, with its approval state.

id
employeeId
leaveType
startDate
endDate
dayCount
status
approvedById

Belongs to one Employee
Approved by one Employee as manager

PayrollRun

One pay period processed for the whole organisation.

id
periodStart
periodEnd
status
runById
approvedAt

Has many Payslips

Payslip

One employee's pay for one period, with its breakdown.

id
payrollRunId
employeeId
grossMinorUnits
netMinorUnits
deductions
currency

Belongs to one PayrollRun
Belongs to one Employee