# viyavuriganga19-jpg/rideassure architecture

> Architecture diagram of the GitHub repository viyavuriganga19-jpg/rideassure, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/viyavuriganga19-jpg/rideassure
- Repository: https://github.com/viyavuriganga19-jpg/rideassure

## Overview

Rideflow is a Tirupati campus-ride booking frontend. Users discover ride and safety information, sign in by role, and reach booking or role-specific dashboards; an alternate page simulates SMS/IVR booking. The source shows client-side state and demo data rather than a backend or persistent ride service. The graph preserves the documented UI capability areas and routed pages; unsampled dashboard and admin-login behavior is not inferred beyond the routes visible in App.tsx.

Main entry points: [`tirupati-rideflow-ai-main/src/App.tsx`](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/App.tsx) (Route app), [`tirupati-rideflow-ai-main/src/pages/Index.tsx`](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/Index.tsx) (Landing page), [`tirupati-rideflow-ai-main/src/components/PrivateRoute.tsx`](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/PrivateRoute.tsx) (Role guard), [`tirupati-rideflow-ai-main/src/pages/StudentDashboard.tsx`](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/StudentDashboard.tsx) (Student dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App and access"]
  node_app["Route app<br/>[App.tsx]"]
  node_studentlogin["Student login<br/>[StudentLogin.tsx]"]
  node_driverlogin["Driver login<br/>[DriverLogin.tsx]"]
  node_adminlogin["Admin login<br/>[AdminLogin.tsx]"]
  node_guard["Role guard<br/>[PrivateRoute.tsx]"]
end

subgraph group_discovery["Ride discovery"]
  node_home["Landing page<br/>[Index.tsx]"]
  node_navigation["Navigation<br/>[Navigation.tsx]"]
  node_hero["Ride overview<br/>[Hero.tsx]"]
  node_heatmap["Live heatmap<br/>[LiveHeatmap.tsx]"]
  node_fares["Fare dashboard<br/>[FareDashboard.tsx]"]
  node_pooling["Ride pooling"]
  node_safety["Safety features<br/>[SafetyFeatures.tsx]"]
  node_chatbot["AI chatbot<br/>[AIChatbot.tsx]"]
end

subgraph group_booking["Booking"]
  node_bookingpage["Ride booking<br/>[BookingPage.tsx]"]
  node_offline["SMS/IVR booking<br/>[OfflineBooking.tsx]"]
end

subgraph group_operations["Ride operations"]
  node_studentdash["Student dashboard"]
  node_driverdash["Driver dashboard"]
  node_admindash["Admin dashboard<br/>[AdminDashboard.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"routes"| node_home
node_app -->|"routes"| node_studentlogin
node_app -->|"routes"| node_driverlogin
node_app -->|"routes"| node_adminlogin
node_app -->|"wraps access"| node_guard
node_guard -.->|"guards route"| node_studentdash
node_guard -.->|"guards route"| node_driverdash
node_app -->|"routes"| node_studentdash
node_app -->|"routes"| node_driverdash
node_app -->|"routes"| node_admindash
node_app -->|"routes"| node_bookingpage
node_app -->|"routes"| node_offline
node_studentlogin -->|"navigates"| node_studentdash
node_driverlogin -->|"navigates"| node_driverdash
node_home -->|"renders"| node_navigation
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_heatmap
node_home -->|"renders"| node_fares
node_home -->|"renders"| node_pooling
node_home -->|"renders"| node_safety
node_home -->|"renders"| node_chatbot
node_fares -->|"links to"| node_offline

click node_app "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/App.tsx"
click node_home "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/Index.tsx"
click node_navigation "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/Navigation.tsx"
click node_hero "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/Hero.tsx"
click node_heatmap "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/LiveHeatmap.tsx"
click node_fares "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/FareDashboard.tsx"
click node_pooling "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/RidePoolingWall.tsx"
click node_safety "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/SafetyFeatures.tsx"
click node_chatbot "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/AIChatbot.tsx"
click node_studentlogin "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/StudentLogin.tsx"
click node_driverlogin "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/DriverLogin.tsx"
click node_adminlogin "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/AdminLogin.tsx"
click node_guard "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/PrivateRoute.tsx"
click node_bookingpage "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/BookingPage.tsx"
click node_offline "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/OfflineBooking.tsx"
click node_studentdash "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/StudentDashboard.tsx"
click node_driverdash "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/DriverDashboard.tsx"
click node_admindash "https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/AdminDashboard.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_studentlogin,node_driverlogin,node_adminlogin,node_guard toneBlue
class node_home,node_navigation,node_hero,node_heatmap,node_fares,node_pooling,node_safety,node_chatbot toneAmber
class node_bookingpage,node_offline toneMint
class node_studentdash,node_driverdash,node_admindash toneRose
class node_visitor toneIndigo
```

## Components

### App and access

- [Route app](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/App.tsx): `tirupati-rideflow-ai-main/src/App.tsx`
- [Student login](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/StudentLogin.tsx): `tirupati-rideflow-ai-main/src/pages/StudentLogin.tsx`
- [Driver login](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/DriverLogin.tsx): `tirupati-rideflow-ai-main/src/pages/DriverLogin.tsx`
- [Admin login](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/AdminLogin.tsx): `tirupati-rideflow-ai-main/src/pages/AdminLogin.tsx`
- [Role guard](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/PrivateRoute.tsx): `tirupati-rideflow-ai-main/src/components/PrivateRoute.tsx`

### Ride discovery

- [Landing page](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/Index.tsx): `tirupati-rideflow-ai-main/src/pages/Index.tsx`
- [Navigation](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/Navigation.tsx): `tirupati-rideflow-ai-main/src/components/Navigation.tsx`
- [Ride overview](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/Hero.tsx): `tirupati-rideflow-ai-main/src/components/Hero.tsx`
- [Live heatmap](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/LiveHeatmap.tsx): `tirupati-rideflow-ai-main/src/components/LiveHeatmap.tsx`
- [Fare dashboard](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/FareDashboard.tsx): `tirupati-rideflow-ai-main/src/components/FareDashboard.tsx`
- [Ride pooling](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/RidePoolingWall.tsx): `tirupati-rideflow-ai-main/src/components/RidePoolingWall.tsx`
- [Safety features](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/SafetyFeatures.tsx): `tirupati-rideflow-ai-main/src/components/SafetyFeatures.tsx`
- [AI chatbot](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/components/AIChatbot.tsx): `tirupati-rideflow-ai-main/src/components/AIChatbot.tsx`

### Booking

- [Ride booking](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/BookingPage.tsx): `tirupati-rideflow-ai-main/src/pages/BookingPage.tsx`
- [SMS/IVR booking](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/OfflineBooking.tsx): `tirupati-rideflow-ai-main/src/pages/OfflineBooking.tsx`

### Ride operations

- [Student dashboard](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/StudentDashboard.tsx): `tirupati-rideflow-ai-main/src/pages/StudentDashboard.tsx`
- [Driver dashboard](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/DriverDashboard.tsx): `tirupati-rideflow-ai-main/src/pages/DriverDashboard.tsx`
- [Admin dashboard](https://github.com/viyavuriganga19-jpg/rideassure/blob/main/tirupati-rideflow-ai-main/src/pages/AdminDashboard.tsx): `tirupati-rideflow-ai-main/src/pages/AdminDashboard.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → Route app: opens
- Route app → Landing page: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Student login: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Driver login: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Admin login: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Role guard: wraps access (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Role guard → Student dashboard: guards route (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Role guard → Driver dashboard: guards route (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Student dashboard: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Driver dashboard: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Admin dashboard: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → Ride booking: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Route app → SMS/IVR booking: routes (evidence: `tirupati-rideflow-ai-main/src/App.tsx`)
- Student login → Student dashboard: navigates (evidence: `tirupati-rideflow-ai-main/src/pages/StudentLogin.tsx`)
- Driver login → Driver dashboard: navigates (evidence: `tirupati-rideflow-ai-main/src/pages/DriverLogin.tsx`)
- Landing page → Navigation: renders (evidence: `tirupati-rideflow-ai-main/src/pages/Index.tsx`)
- Landing page → Ride overview: renders (evidence: `tirupati-rideflow-ai-main/src/pages/Index.tsx`)
- Landing page → Live heatmap: renders (evidence: `tirupati-rideflow-ai-main/src/pages/Index.tsx`)
- Landing page → Fare dashboard: renders (evidence: `tirupati-rideflow-ai-main/src/pages/Index.tsx`)
- Landing page → Ride pooling: renders (evidence: `tirupati-rideflow-ai-main/src/pages/Index.tsx`)
- Landing page → Safety features: renders (evidence: `tirupati-rideflow-ai-main/src/pages/Index.tsx`)
- Landing page → AI chatbot: renders (evidence: `tirupati-rideflow-ai-main/src/pages/Index.tsx`)
- Fare dashboard → SMS/IVR booking: links to (evidence: `tirupati-rideflow-ai-main/src/components/FareDashboard.tsx`)
