Skip to content

πŸš€ A modern Employee Management System (EMS) built with React.js, Tailwind CSS, and Vite. Features include task assignment, progress tracking, role-based dashboards, and a sleek glassmorphism UI. Perfect for organizations to streamline employee task management with real-time updates.

Notifications You must be signed in to change notification settings

AliAbdullahpgr/Employee-Management-System

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏒 Employee Management System

A modern, responsive Employee Management System built with React.js, featuring task assignment, progress tracking, and role-based dashboards. Perfect for organizations looking to streamline their employee task management workflow.

Employee Management System Tailwind CSS Vite License

✨ Features

πŸ‘¨β€πŸ’Ό Admin Dashboard

  • Task Creation & Assignment - Create tasks and assign them to specific employees
  • Employee Overview - View all employees and their task statistics
  • Real-time Updates - See task status changes in real-time
  • Task Categories - Organize tasks by departments (Development, Design, Marketing, etc.)

πŸ‘©β€πŸ’» Employee Dashboard

  • Personal Task View - See all assigned tasks in an organized layout
  • Task Status Management - Accept, complete, or mark tasks as failed
  • Progress Tracking - Visual statistics showing task completion rates
  • Interactive Task Cards - Modern card-based interface for task management

🎨 Modern UI/UX

  • Glass Morphism Design - Beautiful backdrop blur effects and transparency
  • Responsive Layout - Works perfectly on desktop, tablet, and mobile devices
  • Dark Theme - Professional dark theme with gradient backgrounds
  • Smooth Animations - Hover effects, transitions, and micro-interactions
  • Custom Components - Reusable, well-designed UI components

πŸš€ Demo

Admin Login

  • Email: admin@me.com
  • Password: admin

Employee Login

  • Email: employee2@example.com
  • Email: employee3@example.com
  • Email: employee4@example.com
  • Password: 123

πŸ“Έ Screenshots

Login Page

employee1.png

Admin Dashboard

employee2.png employee3.png

Employee Dashboard

employee4.png

πŸ› οΈ Tech Stack

Technology Purpose
React.js Frontend framework for building user interfaces
Tailwind CSS Utility-first CSS framework for styling
Vite Fast build tool and development server
Context API State management for user authentication and data
Local Storage Client-side data persistence
ESLint Code linting and formatting

πŸ“¦ Installation & Setup

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn package manager

1. Clone the Repository

git clone https://github.com/AliAbdullahpgr/Employee-Management-System.git
cd Employee-Management-System

2. Install Dependencies

npm install
# or
yarn install

3. Start Development Server

npm run dev
# or
yarn dev

4. Build for Production

npm run build
# or
yarn build

5. Preview Production Build

npm run preview
# or
yarn preview

πŸ“ Project Structure

src/
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ Auth/
β”‚   β”‚   └── Login.jsx
β”‚   └── Dashboard/
β”‚       β”œβ”€β”€ AdminDashboard.jsx
β”‚       └── EmployeeDashboard.jsx
β”œβ”€β”€ context/
β”‚   └── AuthProvider.jsx
β”œβ”€β”€ subComponents/
β”‚   β”œβ”€β”€ Header.jsx
β”‚   β”œβ”€β”€ TaskList.jsx
β”‚   β”œβ”€β”€ TaskListNumber.jsx
β”‚   β”œβ”€β”€ CreateTask.jsx
β”‚   └── AllTask.jsx
β”œβ”€β”€ TaskList/
β”‚   β”œβ”€β”€ NewTask.jsx
β”‚   β”œβ”€β”€ AcceptTask.jsx
β”‚   β”œβ”€β”€ CompleteTask.jsx
β”‚   └── FailedTask.jsx
β”œβ”€β”€ utils/
β”‚   └── localStorage.jsx
β”œβ”€β”€ App.jsx
β”œβ”€β”€ main.jsx
└── index.css

πŸ”§ Configuration

Environment Variables

Create a .env file in the root directory:

VITE_APP_TITLE=Employee Management System
VITE_API_URL=http://localhost:3000

Tailwind Configuration

The project uses a custom Tailwind configuration with:

  • Custom color palette
  • Glass morphism utilities
  • Responsive breakpoints
  • Custom animations

🎯 Usage Guide

For Administrators

  1. Login with admin credentials
  2. Create Tasks using the task creation form
  3. Assign Tasks to specific employees from the dropdown
  4. Monitor Progress through the all tasks overview
  5. Track Statistics via the dashboard metrics

For Employees

  1. Login with employee credentials
  2. View Tasks assigned to you on the dashboard
  3. Accept New Tasks by clicking the accept button
  4. Update Status by marking tasks as completed or failed
  5. Monitor Progress through personal statistics

πŸš€ Deployment

Deploy to Netlify

  1. Build the project: npm run build
  2. Deploy the dist folder to Netlify
  3. Configure redirects for SPA routing

Deploy to Vercel

  1. Connect your GitHub repository to Vercel
  2. Set build command: npm run build
  3. Set output directory: dist
  4. Deploy automatically on push

Deploy to GitHub Pages

npm run build
npm run gh-pages

🀝 Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

  • Follow React best practices
  • Use Tailwind CSS for styling
  • Maintain consistent code formatting
  • Write meaningful commit messages
  • Test your changes thoroughly

πŸ“‹ Roadmap

  • Database Integration - Replace localStorage with a proper database
  • Real-time Notifications - WebSocket integration for live updates
  • Email Notifications - Send email alerts for task assignments
  • File Attachments - Allow file uploads for tasks
  • Advanced Analytics - Detailed reporting and analytics
  • Mobile App - React Native mobile application
  • API Documentation - Comprehensive API documentation
  • Unit Testing - Complete test coverage

πŸ› Known Issues

  • Task persistence relies on localStorage (cleared on browser reset)
  • No real-time synchronization between multiple sessions
  • Limited to predefined employee accounts

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2025 Employee Management System

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

πŸ‘¨β€πŸ’» Author

Ali Abdullah

⭐ Show your support

Give a ⭐️ if this project helped you!

πŸ™ Acknowledgments

  • React Team for the amazing framework
  • Tailwind CSS for the utility-first CSS framework
  • Vite for the lightning-fast build tool
  • Heroicons for the beautiful SVG icons
  • Community for inspiration and feedback

Made with ❀️ by Ali Abdullah

⭐ Star this repo if you found it helpful!

About

πŸš€ A modern Employee Management System (EMS) built with React.js, Tailwind CSS, and Vite. Features include task assignment, progress tracking, role-based dashboards, and a sleek glassmorphism UI. Perfect for organizations to streamline employee task management with real-time updates.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors