Repository navigation
Releases
Releases · devag7/jantahr
JantaHR 1.0.0
The first public release of JantaHR: open-source HR and payroll built for Indian law, self-hosted free or run as a cloud service.
Highlights
- Payroll with the statutory work done. EPF with the ₹25,000 wage ceiling, ESI coverage rules, state professional tax (including half-yearly states), labour welfare fund, and TDS with old and new regimes, projection and Form 130. Proration, loss of pay from attendance, arrears, bonus and loans. Runs go generate → approve → paid.
- Labour codes. Wages under the 50% rule, statutory bonus, gratuity and fixed-term employment as notified from November 2025.
- Filing-ready outputs. EPF ECR, ESI contribution file, PT and LWF registers, bank advice, the quarterly TDS extract, and a compliance calendar that tracks every due date with its challan number.
- Everything else HR runs on. Employee records, leave policies with accrual and encashment, shifts, geo-fenced and selfie check-in, biometric push, onboarding, exits with full and final settlement, appraisals, recruitment with one-click hire, expenses, helpdesk, reports and an HR assistant.
- DPDP Act 2023 tooling. Consent ledger, data export, correction and erasure requests with the 90-day window, breach register and retention-aware anonymisation.
- Secure by default. Supabase Auth with two-factor sign-in; PAN, Aadhaar and bank numbers encrypted field by field; role-based access, tenant isolation, audit log and row-level security.
- Web and mobile. Next.js web app with an Apple-style design system, and an Expo app for employee self-service.
Get started
Self-host the complete product on the Supabase stack (Postgres 17 + OrioleDB). Every feature is included, with no employee limit and no licence key:
git clone https://github.com/devag7/jantahr
cd jantahr/deploy/self-hosted
./jantahr.sh setup && ./jantahr.sh upGuides: self-hosting, cloud on Supabase + Vercel, legal basis for every rule.
Requires Node.js 22 for development.
Known limits
Read docs/compliance.md before production use:
- Statutory tables (PT, LWF, tax slabs, holidays) are seed defaults that your chartered accountant must validate before filing.
- The mobile app is type-checked but has not yet been run on a device or simulator.
- DPDP tooling tracks the workflow but does not file with the Data Protection Board.
- Not yet available: bank-API salary disbursement, SSO (SAML/OIDC), Tally/Zoho export, multi-language UI and push notifications.
Contributing
State rules (PT slabs, LWF, holidays) and statutory updates are the most valuable contributions. See CONTRIBUTING.md. Report security issues privately as described in SECURITY.md.
