SmartYatra

SmartYatra is an innovative Public Transport Digitization System designed to modernize urban bus transit services.

Table of Contents

• Introduction
• Problem Statement
• Objectives
• Features
• Installation
• Usage
• Project Structure
• Tech Stack
• Contributing
• License

Introduction

SmartYatra is an innovative Public Transport Digitization System designed to modernize urban bus transit services. By leveraging real-time technology, the system enhances operational efficiency, reduces delays, and improves the overall passenger experience. SmartYatra includes two key panels:

• Driver Panel: Enables real-time bus tracking, fare management, and route optimization based on live traffic updates.
• Passenger Panel: Provides live bus location tracking, optimal route suggestions, estimated arrival times, and contactless fare payment via QR codes.

Problem Statement

Public bus systems often suffer from inefficiencies like uncertain arrival times, poor route optimization, manual fare collection, and a lack of transparency, leading to reduced passenger satisfaction and increased operational costs.

Objectives

1. Real-Time Tracking: Allow passengers to monitor live bus locations.
2. Admin Dashboard: Enable transport operators to manage routes, traffic, and fare collection.
3. Route Optimization: Suggest alternative routes to drivers based on traffic conditions.
4. Digital Payments: Implement QR code-based fare collection to reduce errors.
5. Passenger Dashboard: Provide estimated bus arrival times and fare details.
6. Dynamic Notifications: Inform passengers of delays or route changes in real-time.
7. Data Analytics: Track trends and improve future transport decisions.

Features

• Real-Time Bus Tracking
• Route Optimization
• QR Code Payments
• Live Notifications
• Admin Dashboard

Installation

1. Clone the repository:

   git clone https://github.com/SmartYatra/smart-yatra-frontend
   cd smart-yatra-frontend

2. Install dependencies:

   pnpm install

3. Run the application:

   pnpm dev

   The application should now be running on http://localhost:5173.

Project Structure

smart-yatra-frontend/
│
├── src/
│   ├── components/          # Reusable components (Header, Footer, SignInForm, etc.)
│   ├── features/            # Feature modules (DriverPanel, PassengerPanel, AdminDashboard)
│   ├── App.tsx              # Root application component
│   ├── main.tsx             # Application entry point
│   └── ...                  # Other files and assets
│
├── public/                  # Static assets
├── package.json             # Project dependencies and scripts
└── README.md                # Project documentation

Tech Stack

• Frontend: React, TypeScript, React Router
• UI: Tailwind CSS, Lucide Icons
• State Management: Context API, React Hooks
• Build Tool: Vite

Contributing

Contributions are welcome! To contribute, please:

1. Fork the repository.
2. Create a new branch with a descriptive name.
3. Test changes thoroughly.
4. Commit and push your changes.
5. Submit a pull request describing your modifications.

License

This project is licensed under the MIT License. See the LICENSE file for more information.