mordekai32/epms

★ 18JavaScriptAudience · pm founderComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((repo))
    Features
      Goal management
      Performance reviews
      KPI tracking
      Export PDF Excel
    Tech Stack
      React Vite frontend
      Node.js Express backend
      MongoDB Atlas
      JWT auth
    Roles
      Manager view
      Employee view
    Setup
      npm install frontend
      npm install backend
      MongoDB Atlas account

mindmap root((repo)) Features Goal management Performance reviews KPI tracking Export PDF Excel Tech Stack React Vite frontend Node.js Express backend MongoDB Atlas JWT auth Roles Manager view Employee view Setup npm install frontend npm install backend MongoDB Atlas account

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Deploy as an internal HR tool to track employee goals and run quarterly performance reviews with role-separated views for managers and staff.

USE CASE 2

Use as a full-stack reference app for building your own performance management system with JWT auth and a MongoDB backend.

USE CASE 3

Fork and extend with the planned AI performance analysis feature to add automated review suggestions for managers.

USE CASE 4

Study how to implement exportable PDF and Excel reports alongside real-time dashboard charts in a React and Node.js application.

Tech stack

ReactNode.jsExpressMongoDB AtlasViteTailwind CSSJWT

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a MongoDB Atlas cloud account configured separately before running either the frontend or backend dev server.

Use, copy, modify, and distribute freely for any purpose, including commercial use, as long as you keep the original copyright notice.

In plain English

EPMS is a web application for managing employee performance inside an organization. It covers the full cycle from tracking who works in which department, to setting goals, running performance reviews, and generating reports. The project is built with React on the front end and Node.js with Express on the back end, using MongoDB Atlas as the database. Access to the system is controlled by roles, so managers and employees see different views and have different permissions. Authentication is handled with JWT tokens, which are short-lived credentials issued when a user logs in rather than a permanent password stored in a cookie. The feature set covers employee profiles and department assignments, key performance indicator tracking, goal management, performance evaluations, and a real-time dashboard with charts showing statistics and activity. Reports can be exported to PDF or Excel, and the system sends reminders for upcoming performance reviews. Setting it up requires cloning the repository, installing dependencies separately for the frontend and backend with npm, and running both development servers. The frontend uses Vite as its build tool and Tailwind CSS for styling. The backend connects to a MongoDB Atlas cloud database, which needs to be configured separately. The codebase is a student or personal project by a developer named Mordekai, released under the MIT license. The README lists several planned future additions including AI-powered performance analysis, mobile app support, attendance management, and multi-language support, but none of these are implemented yet.

Copy-paste prompts

Prompt 1

I cloned the EPMS repo. Walk me through setting up the MongoDB Atlas connection and configuring environment variables for both the frontend and backend.

Prompt 2

In the EPMS Express backend, how do I add a new role called HR Admin with permissions to view all employee records across departments?

Prompt 3

Help me add a new performance review template to the EPMS app that includes a 360-degree feedback section where peers can rate each other.

Prompt 4

In the EPMS React frontend, generate a new dashboard chart showing average KPI scores per department over the last six months.

Open on GitHub → Explain another repo

← mordekai32 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.