Tech Stack
| Layer | Technology |
|---|---|
| Frontend | React 19, Vite, Tailwind CSS v4, Zustand, Axios, React Router v7 |
| Backend | Node.js, Express 4, MongoDB Atlas, Mongoose |
| Auth | JWT (access + refresh tokens), httpOnly cookies, OTP-based password reset |
| Payments | Razorpay (orders + webhooks) |
| Storage | Cloudinary (car images, avatars, documents) |
| Nodemailer via Resend SMTP |
Project Structure
car/
├── api/ # Express backend (port 5000)
│ └── src/
│ ├── app.js # Express app: middleware, routes (no .listen/DB connect)
│ ├── server.js # Entry point: connects DB, then app.listen(...)
│ ├── config/ # DB, Cloudinary
│ ├── model/ # Mongoose schemas
│ ├── controllers/ # Route handlers
│ ├── routes/ # Express routers
│ ├── middleware/ # Auth, error handler, multer/Cloudinary upload
│ ├── utils/ # JWT, email, OTP, logger (Winston)
│ └── seed.js # Seed script (cars, locations, users)
├── e2e/ # Playwright smoke tests (run against the built web app, API mocked)
└── web/ # React + Vite frontend (port 5173)
└── src/
├── api/ # Axios client + domain helpers (cars, bookings, payments…)
├── store/ # Zustand auth store
├── components/ # Layout, Navbar, Footer, ProtectedRoute, UI components
└── pages/ # Route-level pages (Home, Cars, CarDetail, Booking, Admin…)
Getting Started
Prerequisites
- Node.js 20+
- MongoDB Atlas cluster (or local MongoDB on port
27017) - Cloudinary account
- Razorpay account (test keys work for development)
- Resend account (or any SMTP provider)
1. Configure environment variables
Create api/.env (never commit this file — see api/.env.example):
# Server
NODE_ENV=development
PORT=5000
# Database
MONGO_URL=mongodb+srv://<user>:<pass>@<cluster>.mongodb.net/car_rental
# JWT
JWT_SECRET=<random string, min 32 chars>
JWT_EXPIRES_IN=7d
JWT_REFRESH_SECRET=<different random string, min 32 chars>
JWT_REFRESH_EXPIRES_IN=30d
# Frontend URL (used in CORS and email links)
FRONTEND_URL=http://localhost:5173
# Cloudinary
CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=
# Razorpay
RAZORPAY_KEY_ID=rzp_test_...
RAZORPAY_KEY_SECRET=...
RAZORPAY_WEBHOOK_SECRET=...
# Email — Resend SMTP
EMAIL_HOST=smtp.resend.com
EMAIL_PORT=587
EMAIL_USER=resend
EMAIL_PASSWORD=<resend_api_key>
EMAIL_FROM=onboarding@resend.dev
# Rate limiting
RATE_LIMIT_WINDOW_MS=900000
RATE_LIMIT_MAX=100
# Auth rate limiting (optional; defaults shown)
AUTH_RATE_LIMIT_WINDOW_MS=900000 # login / verify-otp / reset-password: failed attempts per window per IP
AUTH_RATE_LIMIT_MAX=10
OTP_REQUEST_RATE_LIMIT_WINDOW_MS=3600000 # forgot-password: requests per window per IP
OTP_REQUEST_RATE_LIMIT_MAX=5
CONTACT_RATE_LIMIT_WINDOW_MS=3600000 # contact form: submissions per window per IP
CONTACT_RATE_LIMIT_MAX=5