RepairBook Pro is a complete, production-ready device repair shop 
management system built with React, Node.js, PostgreSQL, and Prisma ORM. 
It comes with a fully functional booking engine, Stripe payment integration, 
EasyShip shipping automation, 90-day warranty management, and a powerful 
admin dashboard — everything you need to run a professional repair business.

Whether you run a smartphone repair shop, a laptop service center, or a 
multi-device repair business, RepairBook Pro gives you the complete toolkit 
to manage bookings, payments, shipping, warranties, and customers from one 
centralized platform.

⚙️ Platform Features

📅 Booking System

• Multi-step booking wizard with smart scheduling
• 3 service modes: Visit Store, Onsite, Mail-In
• Real-time slot management and technician availability
• Automated booking confirmation emails sent to customers

💳 Stripe Payments

• Secure custom % deposit payment at booking via Stripe
• Automated balance payment when repair is completed
• Full refund management with configurable policy rules
• Supports 135+ currencies worldwide

📦 EasyShip Logistics

• Automated inbound shipping label generation
• Automated return shipping after repair completion
• Real-time tracking shared with customers
• Integrated with 50+ global shipping carriers

🛡️ 90-Day Warranty System

• Warranty automatically activates on return shipment
• Customers can submit warranty claims via dashboard
• Before/after photo comparison using Cloudinary
• Admin can approve or reject claims with notes

🖥️ Admin Dashboard

• Real-time analytics: revenue, bookings, completion rate
• Full booking lifecycle management
• Device Types, Models, and Service Types CRUD management
• User management with role-based access control
• Country management with currency and tax rules
• System settings: deposit %, warranty days, email templates

👤 User Dashboard

• Complete booking history and repair status tracking
• Payment history with downloadable PDF invoices
• Warranty claim submission and tracking
• Real-time in-app and email notifications

🔐 Security

• JWT authentication with refresh tokens
• TOTP 2FA for admin accounts
• Bcrypt password hashing
• Email verification for new user accounts
• CORS protection and API rate limiting

🔔 Notifications

• SendGrid email notifications at every booking stage
• Real-time in-app notifications
• 8 fully customizable email templates

📄 PDF Generation

• Automated PDF invoice generation
• Powered by Puppeteer + Google Chrome
• Professional invoice layout with business details and branding

🧩 System Requirements

Before starting the project, make sure you have the following tools and accounts available:

• 🟢 Node.js – v18 or higher
• 🐘 PostgreSQL – v14 or higher (or use a free cloud database from Neon.tech)
• 💳 Stripe Account – for payment processing
• 📧 SendGrid Account – for email services (free tier available)
• ☁️ Cloudinary Account – for image storage (free tier: 25GB storage)
• 📦 EasyShip Account – (optional — manual shipping mode is also available)
• 📍 LocationIQ Account – for geolocation services (free tier: 10,000 requests/day)
• 🌐 Google Chrome – required for PDF generation

🚀 Setup Guide

Follow these steps to run the project locally.

1️⃣ Extract the Project

📦 Extract the downloaded ZIP file to your desired folder.

2️⃣ Open Documentation

📄 Open documentation.html to view the complete setup and configuration guide.

3️⃣ Configure Environment Variables

⚙️ Create and configure your .env file with the required API keys and environment settings.

4️⃣ Start the Backend Server

🖥️ Run the backend server using the following command:

cd RepairBookPro-backend
npm run dev

5️⃣ Start the Frontend

💻 Start the frontend application:

cd RepairBookPro-frontend
npm run dev

6️⃣ Access the Application

🌐 Open the user frontend in your browser:

http://localhost:3000

🌍 Frontend Demo

🔗 Live Demo:
https://repairbookpro.com/home