PG Manager Pro

A modern, full-featured Paying Guest (PG) Management System Streamline your PG operations with automated rent collection, real-time occupancy tracking, and comprehensive tenant management.

Comment

🏠 PG Manager Pro

A modern, full-featured Paying Guest (PG) Management System built with React, TypeScript, and Tailwind CSS. Streamline your PG operations with automated rent collection, real-time occupancy tracking, and comprehensive tenant management.

✨ Features

📊 Dashboard

  • Real-time KPIs: Total revenue, occupancy rate, active rooms, pending dues
  • Revenue Analytics: Visual bar charts showing monthly revenue trends
  • Activity Feed: Recent payments, bookings, and maintenance updates

🛏️ Room Management

  • Add, edit, and manage individual rooms
  • Track room status (Occupied, Available, Maintenance)
  • Configure occupancy types (Single, Double, Triple)
  • Set monthly rent and security deposit amounts

👥 Tenant Management

  • Complete tenant lifecycle management
  • Contact information and documentation
  • Status tracking (Active, Notice Period, Inactive)
  • Search and filter capabilities

📅 Booking System

  • Quick booking form for rapid entry
  • Calendar and table view options
  • Booking status tracking (Active, Upcoming, Completed)
  • Multi-PG property support

💰 Payment Tracking

  • Comprehensive payment records
  • Status tracking (Paid, Pending, Overdue, Partial)
  • Multiple payment methods support
  • Financial summary and analytics

⚙️ Settings & Notifications

  • Automated rent payment reminders (Email & SMS)
  • Configurable notification schedules
  • Property and account settings
  • Backend server status monitoring ## 🛠️ Tech Stack
Category Technology
Frontend React 18, TypeScript, Vite
Styling Tailwind CSS, ShadCN UI
State Management React Context, TanStack Query
Routing React Router v6
Forms React Hook Form, Zod
Charts Recharts
Backend Node.js, Express
Notifications Email (Nodemailer), SMS (Twilio)

🚀 Getting Started

Prerequisites

Installation

# Clone the repository
git clone https://github.com/Yash-Kavaiya/pg-manager-pro.git

# Navigate to project directory
cd pg-manager-pro

# Install dependencies
npm install

# Start development server
npm run dev

The app will be available at http://localhost:8080

Backend Setup (for Notifications)

# Navigate to server directory
cd server

# Install backend dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your email and SMS credentials

# Start the backend server
npm run dev

📧 Automated Rent Reminders

PG Manager Pro includes an automated notification system for rent payment reminders.

Features

  • Email & SMS Notifications: Automated reminders to tenants
  • Configurable Schedule: Set days before due date for reminders
  • Overdue Alerts: Automatic notifications for overdue payments
  • Beautiful Templates: Professional HTML emails with payment details
  • Manual Testing: Test notifications with a single click

Configuration

  1. Navigate to Settings → Notifications
  2. Enable Email and/or SMS notifications
  3. Configure reminder schedule (days before due)
  4. Test with "Send Test Notification" button

🧪 Testing

The application has been comprehensively tested using Playwright MCP. All test results and screenshots are available in the test-log/ directory.

Test Coverage

  • ✅ Authentication & Login Flow
  • ✅ Dashboard with KPIs and Charts
  • ✅ Room Management (12 rooms)
  • ✅ Booking System (Table & Calendar views)
  • ✅ Payment Tracking
  • ✅ Tenant Management
  • ✅ Settings & Configuration

Built With

Share this project:

Updates