🚗 Imperial Wheels

Imperial Wheels is a full-stack car and bike rental platform designed to provide users with a seamless vehicle browsing and rental experience.

The application is built using the MERN stack, with a React frontend, Node.js and Express backend, and MongoDB for data storage.

✨ Features

• Browse available cars and bikes
• User registration and authentication
• Secure password hashing using bcrypt
• JWT-based authentication and authorization
• Vehicle rental and booking functionality
• REST API integration between frontend and backend
• MongoDB-based data storage
• Email notification support
• Responsive interface using Bootstrap
• Client-side navigation using React Router

🛠️ Tech Stack

Frontend

• React.js
• Vite
• JavaScript
• Bootstrap 5
• React Router
• Axios

Backend

• Node.js
• Express.js
• MongoDB
• Mongoose
• JSON Web Token (JWT)
• bcrypt.js
• Nodemailer
• Resend
• dotenv

📂 Project Structure

imperial-wheels/
├── Backend/
│   ├── config/
│   ├── controllers/
│   ├── models/
│   ├── routes/
│   ├── server.js
│   └── package.json
│
├── Frontend/
│   ├── public/
│   ├── src/
│   ├── index.html
│   ├── vite.config.js
│   └── package.json
│
├── .gitignore
└── README.md

🚀 Getting Started

1. Clone the repository

git clone https://github.com/parnika0110/imperial-wheels.git
cd imperial-wheels

2. Install Backend Dependencies

cd Backend
npm install

3. Configure Environment Variables

Create a .env file inside the Backend directory and configure the required environment variables for:

• MongoDB connection
• JWT authentication
• Email service

Sensitive credentials and API keys should never be committed to the repository.

4. Start the Backend

npm run dev

5. Install Frontend Dependencies

Open another terminal and run:

cd Frontend
npm install
npm run dev

The Vite development server will display the local URL where the application can be accessed.

🔐 Security

Sensitive information such as database credentials, API keys, and environment variables is excluded from version control using .gitignore.

🔮 Future Enhancements

• Online payment integration
• Advanced vehicle search and filtering
• Admin analytics dashboard
• Enhanced booking management
• Cloud deployment

🤝 Collaboration

Imperial Wheels was developed collaboratively as a team project. The repository preserves the original Git commit history to maintain accurate attribution of contributions.

👨‍💻 Contributors

• Parnika S M
• Jayashankar P