A smart and seamless AI leave management system designed for modern workplaces using modern AI.
Request, approve, and track leaves in real time with AI smart automation, google calendar sync, and effortless transparency.
No spreadsheets, no hassle, just smooth leave management that keeps work and life in balance.

• Currently It supports 4 tool methods for each task:

  • Get Events - Fetches all the events from Calendar.
  • Create Event - Creates or marks leaves on the calendar based on the employee’s leave balance, and syncs with Google Calendar.
  • Delete Event- Deletes any event from the calendar.
  • Show Balance- Displays the current employee’s leave balance.

• Role-based Access Control

  • Admin
    • Create and manage users
    • Assign leave quotas
    • Create projects and groups
  • Manager
    • Approve or reject leave requests
    • Trigger automatic email confirmations on each action
  • Team Member
    • Apply for leave
    • Cancel/reject their own leaves
    • View history of approved, rejected, and cancelled leaves

• Leave Quota Management

  • Each user is assigned a custom leave quota.

• Interactive Calendar

  • A shared big calendar where all users can view applied/approved leaves.
  • Calendar updates automatically when leaves are approved (sometimes requires a refresh).

• Google Calendar Sync

  • Once a leave is approved, it is automatically synced to Google Calendar.

• Gmail Authentication

  • Logging in via Gmail automatically makes you an Admin, enabling configuration of system details.

1. Team Member applies for leave.

2. Manager approves/rejects the request.

   • Email confirmation is sent automatically.

3. Approved leaves appear on:

   • The shared big calendar inside the app

   • The user’s Google Calendar (if Gmail login is used)

   • Pressing on a username will open a popup with user details.

   • When running in Docker, clicking on the calendar icon will send an email containing a Google Calendar link.

   • Opening this link grants you permission to view live events synced with Google Calendar.

   • 

4. Admin configures users, leave quotas, projects, and groups.

• Frontend: React / ShadCN / TailwindCSS
• Backend: Node.js / Express / Prisma
• Gen Ai: LangChain, LangGraph, GROQ LLms, AI Tools
• Database: PostgreSQL (Supabase / pgAdmin)
• Authentication: Google OAuth (Gmail login) / JWT
• Email Service: Gmail API / Nodemailer
• Calendar Sync: Google Calendar API
• Cache: React Query
• Containerization: Docker

For quick testing, you can use the following demo accounts:

1. Admin → Email: mark@leave-tracker.com Password: mark
2. Manager → Email: john@leave-tracker.com Password: john
3. Team Member → Email: sam@leave-tracker.com Password: sam

# Clone the repo
git clone https://github.com/A-ryan-Kalra/leave-tracker-AI
cd leave-tracker

# Install dependencies
npm install

# Run the app
npm run dev

Before running the Docker container , please follow these steps carefully:

1. Clone the repository

git clone https://github.com/A-ryan-Kalra/leave-tracker-AI
cd leave-tracker

2. Set up environment variables

• You will find the .env.example file stored in the server directory.
• Rename the .env.example to .env file:
• Open .env file and fill in your own credentials and fill all the environment variables as required:
• ⚠️ Make sure the GOOGLE_CLIENT_ID and VITE_GOOGLE_CLIENT_ID used in the docker-compose.yml file must share the same ID.

3. Run Docker Compose

docker compose up

4. The app will now start and be available at http://localhost:3000