A comprehensive ERP solution to streamline user management, leave, payroll, asset management, and more.
Made with ♥ by Zeon Studio
If you find this project useful, please give it a ⭐ to show your support.
- 👥 User Management with detailed information
- 👥 Onboarding Steps for New Employees
- 🎯 Different Dashboards for Admin, Moderator and User
- 🔍 Search Functionality on every page
- 🏷️ Payroll Management with salary, bonus, and extra pay
- 🔗 Tools and 3rd-party Account management
- 📚 Online Course Management
- 📱 Asset Management
- 🏖️ Leave Management
- 📆 Holiday and Event Calendar
- ⚙️ Settings to manage every module and app configuration
To get a local copy up and running, please follow these simple steps.
To start using this project, you need to have some prerequisites installed on your machine.
- Node v22+
- MongoDB Compass
- Yarn(Recommended)
- Github Account (For Project Fork)
- Google Console API (For Google Authentication)
- Gmail App Pass (For Sending Email with Nodemailer)
- Discord Webhook URL (For Discord Notification)
- MongoDB Atlas (For MongoDB Database)
- Digital Ocean Space (For Uploading Documents)
- Vercel Account (For Deployment)
- Clone frontend repo
git clone https://github.com/zeon-studio/open-hr.git- Go to the project folder
cd open-hr- Install packages with yarn
yarn- Set up your .env file
- Duplicate .env.example to .env
- Fullfil every env field
- Create a Google Cloud Client ID for the Web application for Gmail authentication.
- Quick start with Yarn
yarn dev- Clone backend repo
git clone https://github.com/zeon-studio/open-hr-backend.git- Go to the project folder
cd open-hr-backend- Install packages with yarn
yarn- Set up your .env file
- Duplicate .env.example to .env
- Fullfil every env field
- Quick start with Yarn
yarn startAfter you finish your development, you can build or deploy your project. Let's see the process:
You can use the following command to build your project locally (Frontend and Backend). It will purge all the unused CSS and minify all the files.
yarn buildIf your project built successfully on local, you can deploy it to vercel, render, or any other hosting platform.
To deploy the backend to Vercel, you can use the vercel.json configuration file. Simply overwrite the build command to yarn build on the Vercel platform and don't forget to add the environment variables to Vercel. This will ensure that the backend is built and deployed correctly.
To deploy the frontend to Vercel, Simply overwrite the build command to yarn build on the Vercel platform and don't forget to add the environment variables to Vercel. This will ensure that the backend is built and deployed correctly.
After deploying the backend, you can upload sample data to the database using Mongodb Compass. Follow these steps:
- Open Mongodb Compass and connect to your MongoDB database.
- Navigate to the
open-hrdatabase. - Upload
example-data/employee.jsonto theemployeescollection. [make sure you have changed thework_emailto your email address, so that you can login with it] - Upload
example-data/settings.jsonto thesettingscollection.
After uploading the sample data, you can login to the dashboard using the email address that you used in the example-data/employee.json file. Just click on the login with Google button and you will be redirected to the dashboard.
We use GitHub Issues as the official bug tracker for this Template. Please Search existing issues. It’s possible someone has already reported the same problem. If your problem or idea has not been addressed yet, feel free to open a new issue.
Copyright (c) 2025 - Present, Designed & Developed by Zeon Studio
Code License: Released under the MIT license.
If you need to set up the application, app customization, or complete application development services from scratch you can Hire Us.