Skip to content

abdullah107189/Ride-Booking-System-Frontend

Repository files navigation

🚗 RideShare - Complete Ride Management System

A full-stack ride-sharing platform built with React 19, TypeScript, Redux Toolkit, and Tailwind CSS. Featuring separate dashboards for Riders, Drivers, and Administrators with real-time ride tracking, payment processing, and comprehensive management capabilities.

🎓 Assignment Project - Advanced Web Technologies

📋 Project Overview

This project implements a complete ride-sharing ecosystem with three distinct user roles, real-time tracking, secure authentication, and comprehensive administrative controls as per the assignment requirements.

✨ Core Features Implemented

🌐 Public Landing Pages (No Authentication Required)

  • Homepage - 5+ distinct sections: Hero Banner, How-it-works, Features, Testimonials, CTA
  • About Us - Company background, mission, and team information
  • Features - Detailed breakdown of Rider, Driver, and Admin capabilities
  • Contact - Fully validated contact form with simulated submission
  • FAQ - Searchable frequently asked questions section

🔐 Authentication & Authorization System

  • JWT-based Authentication - Secure login/registration with role selection
  • Role-based Access Control - Rider, Driver, and Admin specific dashboards
  • Account Status Handling - Blocked/suspended user redirection
  • Driver Online/Offline Status - Control ride acceptance availability
  • Persistent Sessions - Maintain authentication state across browser sessions

🚴‍♂️ Rider Features

  • Ride Booking - Pickup/destination selection with fare estimation
  • Real-time Tracking - Live ride status updates with driver details
  • Ride History - Paginated list with search and filter capabilities
  • Profile Management - Edit personal information and change password
  • Payment Methods - Secure payment option management

🚗 Driver Features

  • Availability Toggle - Online/Offline status control
  • Ride Acceptance - Accept/reject incoming ride requests
  • Ride Management - Status updates (Accepted → Picked Up → In Transit → Completed)
  • Earnings Dashboard - Visual charts for daily/weekly/monthly earnings
  • Vehicle Management - Update vehicle details and documents

👨‍💼 Admin Features

  • User Management - Comprehensive user CRUD operations with search/filter
  • Ride Oversight - View all platform rides with advanced filtering
  • Analytics Dashboard - Data visualizations for platform metrics
  • System Monitoring - Platform performance and activity tracking

🆘 Safety Features

  • Emergency SOS Button - Visible during active rides
  • Live Location Sharing - Real-time GPS location sharing with emergency contacts
  • Multiple Emergency Options - Police, emergency contacts, location sharing
  • Safety Settings - Configurable emergency contacts and preferences

🛠 Complete Tech Stack

Frontend Framework & Language

  • React 19 - Latest React with concurrent features and hooks
  • TypeScript - Full type safety with strict configuration
  • React Router v7 - Declarative routing with protected routes

State Management & API

  • Redux Toolkit - Modern Redux with simplified syntax
  • RTK Query - Powerful data fetching and caching
  • Axios - HTTP client for API communications

UI & Styling

  • Tailwind CSS v4 - Utility-first CSS framework with custom configuration
  • Shadcn/ui - Reusable component library built on Radix UI
  • Radix UI Primitives - Unstyled, accessible component foundations
  • Lucide React - Beautiful & consistent icons
  • Framer Motion - Smooth animations and transitions

Forms & Validation

  • React Hook Form - High-performance form management
  • Zod - TypeScript-first schema validation
  • @hookform/resolvers - Zod integration for form validation

Notifications & UX

  • Sonner - Beautiful toast notifications
  • Skeleton Loaders - Loading states for better UX
  • Error Boundaries - Graceful error handling

Build Tools & Development

  • Vite - Fast development server and build tool
  • TypeScript ESLint - Code quality and type checking
  • Tailwind CSS Vite Plugin - Optimized CSS processing

🚀 Quick Start Guide

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Modern web browser

RideShare Banner

Installation & Setup

  1. Clone and Install
    git clone https://github.com/abdullah107189/Ride-Booking-System-Frontend.git
    cd ride-management-system-frontend
    npm install

About

A full-stack ride-sharing platform built with React 19, TypeScript, Redux Toolkit, and Tailwind CSS. Featuring separate dashboards for Riders, Drivers, and Administrators with real-time ride tracking, payment processing, and comprehensive management capabilities.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages