SimpleHR is a modern, full-featured Human Resource Management system built with Next.js 16, Prisma 7, and NextAuth.js. Designed for small and medium-sized businesses, it covers everything from employee records and payroll to leave management and attendance tracking — all in one clean, responsive interface.

The app supports three deployment strategies out of the box: Cloud (Vercel + Supabase + Cloudinary), VPS with Coolify (SQLite or self-hosted Supabase), and local development. Each deployment comes with a ready-to-use environment template so you can get up and running quickly.

Key highlights that set it apart:

• Field-level AES-256-GCM encryption for sensitive employee data (SSN, IBAN, tax ID, health insurance) — data is protected even if the database is compromised
• Two-Factor Authentication (2FA) via email with automatic account lockout and brute-force protection
• Progressive Web App (PWA) — installable on mobile and desktop with optional real-time web push notifications
• 7 built-in languages (English, Spanish, Turkish, French, German, Italian, Portuguese) with an easy guide to add more
• Role-based access control with three levels: Admin, Manager, and Employee
• Fully configurable — enable or disable any module from the Settings page

• Employee Management — profiles, documents with expiry tracking, onboarding checklists, bulk CSV import/export
• Attendance Tracking — clock in/out by location (office/remote), automatic late detection with configurable grace period, monthly calendar view, CSV export
• Payroll Module — flexible payslips (monthly/weekly/daily), analytics and department charts
• Overtime Management — employee declarations with manager approval workflow
• Advance Payment — salary advance requests with installment repayment tracking
• Leave Encashment — convert unused leave days to cash compensation
• Expenditure / Expense Claims — receipt upload with secure private storage, approval workflow
• Leave Management — customizable leave types, carry-over, allocations, new-year batch allocation
• Leave Requests — employee submission, manager/admin approval with email notifications
• Public Holidays — company calendar with dashboard widget
• Performance Reviews — structured employee evaluations with history
• Employee Warnings — formal disciplinary records with employee acknowledgement
• Departments & Positions — full org structure with color-coded departments
• Organization Chart — auto-generated visual hierarchy from supervisor relationships
• Asset Management — track and assign company assets to employees
• Announcements — company-wide posts visible on the dashboard
• In-App Notifications — real-time updates for all workflow events
• Dashboard — personalized widgets, analytics, upcoming events, onboarding progress tracker
• Settings — SMTP email config, work schedule, feature toggles, permission management, dashboard customization
• Two-Factor Authentication (2FA) — email-based OTP with rate limiting and lockout
• Field-Level Encryption — AES-256-GCM for sensitive data at rest
• Progressive Web App (PWA) — installable, with optional web push notifications
• Multi-Language — 7 languages built in, easy to add more
• Light/Dark Theme — user-selectable for all accounts
• Role-Based Access Control — Admin, Manager, Employee with granular permission settings
• Multiple Deployment Options — Cloud (Vercel + Supabase), VPS Simple (SQLite), VPS Professional (self-hosted Supabase), Development
• Comprehensive Documentation — HTML docs included + live in-app docs viewer at /docs

• Node.js 20.19 or higher
• Database: SQLite (included, zero setup) or PostgreSQL (for cloud/VPS deployments)
• Cloud deployment: Vercel account + Supabase project + Cloudinary account
• VPS deployment: A VPS server with Docker support + Coolify (free, self-hosted)
• Email features (2FA, notifications): Any SMTP provider (Gmail, SendGrid, Resend, etc.)
• File uploads on cloud: Cloudinary account (free tier supported)
• Optional: Cloudflare account for WAF and DDoS protection

1. Extract the ZIP file and open a terminal in the project folder.

2. Copy the environment template for your deployment type:

• Local development: cp .env.development .env.local
• Cloud (Vercel + Supabase): cp .env.cloud .env.local
• VPS Simple (SQLite): cp .env.vps.basic .env.local
• VPS Professional (Supabase): cp .env.vps.proffessional .env.local

3. Edit .env.local and fill in your values (database URL, NEXTAUTH_SECRET, NEXTAUTH_URL, and SMTP credentials at minimum).

4. Install dependencies:

npm install

5. Initialize the database:

npx prisma generate
npx prisma db push

6. Start the application:

npm run dev (development)
npm run build && npm start (production)

7. Open the app in your browser and follow the Setup Wizard to configure your company, create the admin account, and enable the modules you need.

Full documentation is included in the /documentation folder (open index.html) and is also available in-app at /docs after the app is running.