Repository files navigation

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

• NextJs
• Tailwind CSS
• Shadcn UI
• ReduxJs

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)

1. Clone frontend repo

git clone https://github.com/zeon-studio/open-hr.git

1. Go to the project folder

cd open-hr

1. Install packages with yarn

yarn

1. 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.

1. Quick start with Yarn

yarn dev

1. Clone backend repo

git clone https://github.com/zeon-studio/open-hr-backend.git

1. Go to the project folder

cd open-hr-backend

1. Install packages with yarn

yarn

1. Set up your .env file

• Duplicate .env.example to .env
• Fullfil every env field

1. Quick start with Yarn

yarn start

After 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 build

If 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 thevercel.json configuration file. Simply overwrite the build command toyarn 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 toyarn 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:

1. Open Mongodb Compass and connect to your MongoDB database.
2. Navigate to theopen-hr database.
3. Uploadexample-data/employee.json to theemployees collection. [make sure you have changed thework_email to your email address, so that you can login with it]
4. Uploadexample-data/settings.json to thesettings collection.

After uploading the sample data, you can login to the dashboard using the email address that you used in theexample-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 Searchexisting issues. It’s possible someone has already reported the same problem.If your problem or idea has not been addressed yet, feel free toopen a new issue.

Copyright (c) 2025 - Present, Designed & Developed byZeon Studio

Code License: Released under theMIT license.

If you need to set up the application, app customization, or complete application development services from scratch you canHire Us.