Car Selling Platform Final Year Project

• Secure admin login in the final year project
• Admin-only access using isAdmin flag
• Dedicated admin sidebar layout
• Admin dashboard
• View total revenue in INR
• View pending orders
• View cars in inventory
• View registered users
• View delivered orders
• View cancelled orders
• View total orders
• View total brands
• Recent orders table
• Status badges for orders
• Quick action links
• Cars management
• Create car records
• Add car name
• Select brand
• Add price in INR
• Add stock quantity
• Add image URL
• Add description
• View searchable car table
• View car thumbnail
• View brand
• View price
• View stock
• Update car details through modal
• Live image preview while editing
• Delete car with confirmation
• Filter cars by brand
• Search cars by name
• Brands management
• Create brand
• View brand table
• View brand avatar
• View brand ID
• View created date
• Rename brand
• Delete brand with confirmation
• Orders management
• View all orders
• View customer information
• View order items
• View order total
• View order status
• Mark order as paid
• Mark order as delivered
• Cancel order
• Filter orders by pending, paid, delivered, and cancelled
• Search orders by order ID
• Search orders by customer name or email
• View full order detail modal
• View shipping address
• View line items
• Manage status toggles
• Users management
• Create user
• Add name, email, password, and admin flag
• View users table
• View role badges
• View join date
• Update user details
• Reset user password
• Toggle admin role
• Delete user
• Prevent deleting own account

The admin panel includes dashboard, cars CRUD, brands CRUD, orders management, and users management

• User registration in this final year project
• User login
• JWT-based session
• Bearer token stored in localStorage
• Auto-login after successful registration
• Profile update
• Landing page
• Hero slider with search bar
• Stats bar
• Shop by brand section
• Featured cars grid
• How-it-works section
• Customer testimonials
• Call-to-action banner
• Footer navigation links
• Car inventory page
• Browse all vehicles in responsive grid
• Search cars by name
• Filter cars by brand
• Filter by maximum price in INR
• Sort by newest
• Sort by price
• Sort by name
• Skeleton loading states
• Empty state for no matching results
• Open car detail page
• Car detail page
• Large image gallery
• Brand badge
• Price display in INR
• Car description
• Quantity selector
• Add to cart
• View cart action
• View specs such as SKU, brand, stock, and payment method
• View related cars from same brand
• Shopping cart
• View cart items with thumbnails
• Update quantity
• Remove individual items
• View line totals
• View order summary
• Proceed to checkout
• Empty cart state with inventory link
• Cart persisted in localStorage
• Checkout page
• Login required for checkout
• Delivery address form
• Add name, phone, street, city, state, and ZIP
• Prefill address from saved profile
• Review order items
• Cash on Delivery payment
• Place order through API
• Clear cart after order placement
• My Orders page
• View all user orders as cards
• View order status badges
• View pending, paid, in-transit, delivered, and cancelled statuses
• Progress bar visualization
• View shipping address
• View order items
• View total amount in INR
• Cancel pending orders
• Profile page
• Account tab for name, email, and phone
• Address tab for default delivery address
• Security tab for password change
• Sticky navbar
• Cart badge count
• User dropdown with profile, orders, and sign out
• Admin link visible only for admin users
• Mobile-responsive menu

The user panel includes landing page, inventory, car detail, cart, checkout, orders, profile, login, register, and responsive navigation modules

• Full-stack MERN architecture
• React 18 frontend
• Vite 5 build tool and dev server
• React Router 6 routing
• Context API for Auth and Cart state
• React Toastify notifications
• Custom CSS design system
• Responsive layout
• Fetch API for backend requests
• Node.js backend
• Express 4 REST API
• MongoDB database
• Mongoose 8 ODM
• JWT authentication
• bcryptjs password hashing
• CORS support
• Morgan HTTP request logging
• dotenv environment configuration
• Role-based access using isAdmin
• Private routes
• Admin routes
• Client-side cart persistence
• RESTful public, protected, and admin endpoints
• User, Car, Brand, and Order database models
• Seed database support
• Demo users, brands, cars, and orders
• INR currency formatting
• en-IN locale formatting
• Production frontend build support
• Backend production start support

The uploaded documentation lists React, Vite, React Router, Context API, React Toastify, Fetch API, Node.js, Express, MongoDB, Mongoose, JWT, bcryptjs, CORS, Morgan, and dotenv as the technology stack.

Technology Used

Step 1: Install backend dependencies

cd server

npm install

Step 2: Install frontend dependencies

Open a new terminal:

cd client

npm install

Step 3: Configure server environment

Create server/.env:

PORT=5000

MONGO_URI=mongodb://localhost:27017/mern_car_shop

JWT_SECRET=your_super_secret_jwt_key_change_in_production

CLIENT_URL=http://localhost:5173

[email protected]

ADMIN_PASSWORD=Admin@123

Optional client environment variable for production:

VITE_API_URL=http://localhost:5000

The environment variables include backend port, MongoDB URI, JWT secret, client URL, admin email, and admin password used by the seeder.

Step 4: Start MongoDB

Make sure MongoDB is running locally, or replace MONGO_URI with a MongoDB Atlas connection string.

Step 5: Seed the database

cd server

npm run seed

Or:

node src/seeder/seeder.js

The seeder clears existing data and inserts sample users, brands, cars, and orders.

Step 6: Start backend

Open Terminal 1:

cd server

npm run dev

Backend API runs at:

http://localhost:5000

Step 7: Start frontend

Open Terminal 2:

cd client

npm run dev

Frontend app runs at:

http://localhost:5173

The project uses separate backend and frontend servers during development.

Admin Account

Customer Accounts

Password for all customers:

User@123

The default credentials are available after database seeding