CRPMS — Car Repair & Payment Management System

Full-stack web application for managing car repair shop operations.

Tech Stack

• Frontend: React 19, Vite 8, Tailwind CSS 4, Framer Motion
• Backend: Express 5, Mongoose 9, MongoDB
• Auth: JWT + bcryptjs

Project Structure

├── backend/          # Express REST API
│   ├── models/       # Mongoose schemas (Car, Payment, Service, ServiceRecord, User)
│   ├── routes/       # API route handlers
│   └── server.js     # App entry point
├── frontend/         # React SPA
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   └── assets/
│   └── vite.config.js
└── package.json      # Root workspace with postinstall script

Getting Started

Prerequisites

• Node.js 18+
• MongoDB instance

Setup

git clone <repo-url>
cd crpms-app
npm install

This installs root dependencies and automatically runs npm install in both backend/ and frontend/.

Environment Variables

Copy the example files and fill in your values:

cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

Run (Development)

npm run dev

Starts both backend (Express, default port 5000) and frontend (Vite dev server) concurrently.

Build

npm run build

API Endpoints

| Prefix | Resource | | ------------------- | ---------------- | | /api/auth | User auth | | /api/cars | Car management | | /api/services | Service catalog | | /api/servicerecords | Service records | | /api/payments | Payments |

License

MIT