PayrollPro is a full-stack enterprise payroll management platform designed to automate employee payroll processing, salary management, statutory compliance, and payroll analytics.
The platform provides secure authentication, role-based access control, payroll automation, statutory deductions configuration, and detailed reporting — making payroll processing efficient and scalable for organizations.
This project was built using the MERN Stack (MongoDB, Express.js, React.js, Node.js) with a modular backend architecture and a modern responsive frontend interface.
Managing payroll manually can be complex and error-prone. PayrollPro simplifies this by providing a centralized platform where organizations can:
• Manage employees • Configure statutory deductions • Generate payroll automatically • Produce payslips and reports • Track payroll history
The system is designed to simulate real enterprise payroll workflows used in modern organizations.
- React.js
- Vite
- Tailwind CSS
- Axios
- Modern Dashboard UI
- Node.js
- Express.js
- MongoDB
- Mongoose
- JWT Authentication
- RESTful APIs
- MongoDB
Secure login system with multiple user roles:
- Super Admin
- Payroll Admin
- HR Admin
- Employee
Each role has restricted access to specific modules.
- Organization setup
- Configure payroll environment
- Manage company payroll policies
- Add and manage employees
- Update employee information
- Employee salary structure management
- Employee self-service access
- Define salary components
- Manage allowances and deductions
- Configure salary breakdown
Supports configuration of statutory deductions including:
- Provident Fund (PF)
- Employee State Insurance (ESI)
- Professional Tax
- Income Tax rules
- Run monthly payroll
- Automated salary calculations
- Manage deductions and bonuses
- Generate payroll records
- Automatic payslip generation
- Detailed salary breakdown
- Downloadable payslips
- Payroll reports
- Audit logs
- Payroll insights
- Employee salary summaries
Payroll-management-system
│
├── assets
│ ├── Login_Page.jpeg
│ ├── Dashboard-1.jpeg
│ ├── Employee_page.jpeg
│ ├── Payslips.jpeg
│ ├── Reports.jpeg
│
├── backend
│ ├── config
│ ├── controllers
│ ├── middleware
│ ├── models
│ ├── routes
│ ├── utils
│ └── server.js
│
├── frontend
│
├── .env
├── package.json
└── README.md
git clone https://github.com/Asifa007/Payroll-management-system.git
cd Payroll-management-system
cd backend
npm install
Create a .env file:
PORT=5000
MONGO_URI=mongodb://localhost:27017/payroll_db
JWT_SECRET=your_secret_key
Run backend server:
npm run dev
cd frontend
npm install
npm run dev
Frontend runs on:
http://localhost:5173
MongoDB stores the following collections:
- users
- employees
- payrolls
- payslips
- organizations
- auditlogs
- notifications
Asifa Firdhouse
Responsibilities:
- Backend architecture
- REST API development
- MongoDB database schema design
- Authentication & authorization
- Payroll processing logic
Savita
Responsibilities:
- UI/UX design
- React frontend development
- Dashboard components
- Backend API integration
- Email notifications
- Payslip PDF export
- Multi-organization support
- Advanced payroll analytics
- Mobile responsive improvements
This project is licensed under the MIT License.
You are free to use, modify, and distribute this software with proper attribution.
Asifa Firdhouse Artificial Intelligence & Machine Learning Student Backend Developer
GitHub: https://github.com/Asifa007