Skip to content

mahimapaseda/dream-vehicle-website

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

33 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš— Dream Vehicle - Premium Vehicle Dealership Website

Live Demo React License

🌟 Overview

Dream Vehicle Demo

Dream Vehicle is a modern, responsive vehicle dealership website built with React.js. It offers a seamless experience for browsing, searching, and inquiring about premium vehicles with advanced features like mobile swipe navigation, user authentication, and admin management.

Experience the website: Dream Vehicle Website

🎯 Key Features

  • πŸ” Advanced Search & Filtering - Find vehicles by make, model, price, and type
  • πŸ“± Mobile-First Design - Responsive with swipe navigation for mobile devices
  • πŸ‘€ User Authentication - Secure login/register system with role-based access
  • πŸ›‘οΈ Admin Panel - Complete vehicle management and inquiry tracking
  • πŸ’Ύ Local Storage - Persistent data storage for user preferences and inquiries
  • 🎨 Modern UI/UX - Clean design with smooth animations and transitions
  • ⚑ Performance Optimized - Fast loading with lazy loading and code splitting

πŸŽ₯ Video Demo

πŸ“Ή Watch Full Video Demo - Complete walkthrough of Dream Vehicle features including mobile swipe navigation, authentication system, and admin dashboard.

Demo Highlights:

  • πŸ” Advanced vehicle search and filtering
  • πŸ“± Mobile swipe navigation
  • πŸ” User authentication system
  • πŸ‘¨β€πŸ’Ό Admin dashboard functionality
  • 🎨 Responsive design showcase

Demo Credentials

  • Admin: admin@dreamvehicle.com / admin123
  • Customer: customer@dreamvehicle.com / customer123

πŸ› οΈ Technology Stack

Technology Purpose Version
React.js Frontend Framework 18.2.0
React Router Navigation & Routing 6.x
CSS3 Styling & Animations -
Local Storage Data Persistence -
GitHub Pages Hosting & Deployment -
Service Worker PWA Features -

πŸ“± Features in Detail

πŸ” Authentication System

  • Secure user registration and login
  • Role-based access (Admin/Customer)
  • Protected routes and components
  • Session management with localStorage

πŸš™ Vehicle Management

  • Browse Vehicles: Grid and list view options
  • Advanced Filters: Search by make, model, price range, vehicle type
  • Vehicle Details: Comprehensive information with image galleries
  • Mobile Swipe: Horizontal scrolling on mobile devices
  • Responsive Design: Optimized for all screen sizes

πŸ‘¨β€πŸ’Ό Admin Dashboard

  • Vehicle CRUD Operations: Add, edit, delete vehicles
  • Inquiry Management: View and respond to customer inquiries
  • User Management: Monitor registered users
  • Analytics: Track website usage and inquiries

πŸ‘€ Customer Dashboard

  • Saved Vehicles: Bookmark favorite vehicles
  • Inquiry History: Track submitted inquiries and responses
  • Profile Management: Update personal information
  • Responsive Interface: Mobile-optimized experience

🎨 Design Features

πŸ“± Mobile Experience

  • Swipe Navigation: Horizontal scrolling for vehicle cards
  • Touch Optimized: Smooth touch interactions
  • Responsive Grid: Adaptive layouts for all devices
  • Fixed Navigation: Persistent header for easy access

🎭 UI/UX Elements

  • Smooth Animations: Fade-in effects and transitions
  • Modern Typography: Clean, readable fonts
  • Color Scheme: Professional dark/light theme
  • Interactive Elements: Hover effects and micro-interactions

πŸ”§ Installation & Setup

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn package manager
  • Git

Quick Start

# Clone the repository
git clone https://github.com/mahimapaseda/dream-vehicle-website.git

# Navigate to project directory
cd dream-vehicle-website

# Install dependencies
npm install

# Start development server
npm start

# Build for production
npm run build

# Deploy to GitHub Pages
npm run deploy

Environment Setup

# Install React dependencies
npm install react react-dom react-router-dom

# Install development dependencies
npm install --save-dev gh-pages

πŸ“ Project Structure

dream-vehicle-website/
β”œβ”€β”€ public/
β”‚   β”œβ”€β”€ index.html          # Main HTML template
β”‚   β”œβ”€β”€ manifest.json       # PWA manifest
β”‚   └── sw.js              # Service worker
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ AdminPanel.js   # Admin dashboard
β”‚   β”‚   β”œβ”€β”€ CustomerDashboard.js
β”‚   β”‚   β”œβ”€β”€ Login.js        # Authentication
β”‚   β”‚   β”œβ”€β”€ Register.js
β”‚   β”‚   β”œβ”€β”€ VehicleCard.js  # Vehicle display
β”‚   β”‚   └── VehicleDetails.js
β”‚   β”œβ”€β”€ App.js             # Main application
β”‚   β”œβ”€β”€ index.js           # Entry point
β”‚   └── index.css          # Global styles
β”œβ”€β”€ package.json           # Dependencies
└── README.md             # Documentation

🌐 SEO Optimization

Meta Tags & SEO Features

  • Semantic HTML: Proper heading structure and semantic elements
  • Meta Descriptions: Optimized for search engines
  • Open Graph: Social media sharing optimization
  • Mobile-Friendly: Google Mobile-Friendly certified
  • Fast Loading: Optimized images and code splitting
  • Accessibility: WCAG compliant with proper ARIA labels

Performance Metrics

  • Lighthouse Score: 90+ Performance
  • Core Web Vitals: Optimized LCP, FID, CLS
  • SEO Score: 95+ SEO rating
  • Accessibility: 90+ Accessibility score

πŸ”’ Security Features

  • Input Validation: Client-side form validation
  • XSS Protection: Sanitized user inputs
  • CSRF Protection: Secure form submissions
  • Content Security Policy: Implemented via service worker
  • Secure Headers: Security-focused HTTP headers

πŸ“Š Browser Support

Browser Version Support
Chrome 80+ βœ… Full
Firefox 75+ βœ… Full
Safari 13+ βœ… Full
Edge 80+ βœ… Full
Mobile Safari iOS 13+ βœ… Full
Chrome Mobile Android 8+ βœ… Full

πŸš€ Deployment

GitHub Pages Deployment

# Build and deploy
npm run deploy

# Manual deployment
npm run build
# Upload build folder to hosting service

Custom Domain Setup

  1. Add CNAME file to public folder
  2. Configure DNS settings
  3. Enable HTTPS in repository settings

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

  • Follow React best practices
  • Write clean, commented code
  • Test on multiple devices
  • Maintain responsive design
  • Update documentation

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ‘¨β€πŸ’» Author

Mahima Paseda

πŸ™ Acknowledgments

  • React Team - For the amazing framework
  • GitHub Pages - For free hosting
  • Unsplash - For high-quality vehicle images
  • Community - For feedback and contributions

πŸ“ž Support

For support, email mahimapaseda@example.com or create an issue on GitHub.


⭐ Star this repository if you found it helpful!

GitHub stars GitHub forks

Keywords: vehicle dealership, car website, React.js, responsive design, mobile-first, vehicle search, admin panel, customer dashboard, modern UI, GitHub Pages, PWA, SEO optimized

About

Dream Vehicle - Modern React.js vehicle dealership website with premium car browsing, advanced search filters, mobile swipe navigation, secure user authentication, admin dashboard, and customer portal. Features responsive design, smooth animations and PWA capabilities. Perfect for dealerships.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors