# developer-rudra/ridetogether_ architecture

> Architecture diagram of the GitHub repository developer-rudra/ridetogether_, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/developer-rudra/ridetogether_
- Repository: https://github.com/developer-rudra/ridetogether_

## Overview

RideTogether is a real-time group-ride coordination app. Riders authenticate, create or join a ride, enter its lobby, then use a shared map to exchange live locations and statuses, spot separation, and contact or navigate to riders. REST handles accounts and ride lifecycle; Socket.IO supports live ride coordination. The excerpts show client routing, API calls, ride persistence choices, and authentication; real-time server behavior and several documented capabilities are represented from the README, not inspected source excerpts.

Main entry points: [`client/src/App.jsx`](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/App.jsx) (App routing), [`client/src/services/api.js`](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/services/api.js) (HTTP client), [`client/src/pages/RideMap.jsx`](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/RideMap.jsx) (Shared ride map), [`server/src/app.js`](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/app.js) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Rider app"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Auth context<br/>[AuthContext.jsx]"]
  node_authpages["Login and register<br/>[Login.jsx]"]
  node_dashboard["Ride dashboard<br/>[Dashboard.jsx]"]
  node_create["Create ride<br/>[CreateRide.jsx]"]
  node_join["Join ride<br/>[JoinRide.jsx]"]
  node_lobby["Ride lobby<br/>[RideLobby.jsx]"]
  node_map["Shared ride map<br/>[RideMap.jsx]"]
  node_mapview["Map rendering<br/>[GoogleMapView.jsx]"]
  node_geoutils["Location calculations<br/>[geoUtils.js]"]
  node_api_client["HTTP client<br/>[api.js]"]
  node_socket_client["Socket client<br/>[socket.js]"]
end

subgraph group_api["REST and identity"]
  node_express["Express API<br/>[app.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Account operations<br/>[authController.js]"]
  node_authguard["JWT guard<br/>[authMiddleware.js]"]
  node_userstore[("User records<br/>[User.js]")]
  node_token["JWT cookie<br/>[generateToken.js]"]
  node_health["Health endpoint"]
end

subgraph group_rides["Ride management"]
  node_rideroutes["Ride routes<br/>[rideRoutes.js]"]
  node_ridecontroller["Ride operations<br/>[rideController.js]"]
  node_ridestore[("Ride records<br/>[Ride.js]")]
  node_memory[("Memory fallback<br/>[memoryStore.js]")]
end

subgraph group_realtime["Live coordination"]
  node_socketserver["Socket.IO server<br/>[index.js]"]
  node_live_state[("Live ride state")]
end

node_rider(("Rider"))
node_googlemaps["Google Maps"]
node_phone["Phone service"]
node_mongodb[("MongoDB")]

node_rider -->|"uses"| node_app
node_app -->|"provides auth"| node_authui
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_create
node_app -->|"routes to"| node_join
node_app -->|"routes to"| node_lobby
node_app -->|"routes to"| node_map
node_authpages -->|"authenticates through"| node_authui
node_authui -->|"calls"| node_api_client
node_dashboard -->|"loads rides"| node_api_client
node_create -->|"creates rides"| node_api_client
node_join -->|"joins rides"| node_api_client
node_lobby -->|"loads ride"| node_api_client
node_map -->|"loads and ends ride"| node_api_client
node_map -->|"exchanges live events"| node_socket_client
node_map -->|"renders map"| node_mapview
node_map -->|"calculates distances"| node_geoutils
node_mapview -.->|"displays map"| node_googlemaps
node_map -->|"offers rider calls"| node_phone
node_api_client -->|"sends REST requests"| node_express
node_express -->|"mounts"| node_authroutes
node_express -->|"mounts"| node_rideroutes
node_express -->|"mounts health routes"| node_health
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"protects routes"| node_authguard
node_authcontroller -->|"reads and writes"| node_userstore
node_authcontroller -->|"falls back to"| node_memory
node_authcontroller -->|"sets token cookie"| node_token
node_authguard -->|"loads user"| node_userstore
node_authguard -->|"falls back to"| node_memory
node_rideroutes -->|"requires auth"| node_authguard
node_rideroutes -->|"dispatches"| node_ridecontroller
node_ridecontroller -->|"reads and writes"| node_ridestore
node_ridecontroller -->|"falls back to"| node_memory
node_ridestore -.->|"persists via Mongoose"| node_mongodb
node_socket_client -->|"connects live"| node_socketserver
node_socketserver -->|"maintains rider state"| node_live_state
node_socketserver -->|"checks ride membership"| node_ridestore

click node_app "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/App.jsx"
click node_authui "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/context/AuthContext.jsx"
click node_authpages "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/Login.jsx"
click node_dashboard "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/Dashboard.jsx"
click node_create "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/CreateRide.jsx"
click node_join "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/JoinRide.jsx"
click node_lobby "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/RideLobby.jsx"
click node_map "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/RideMap.jsx"
click node_mapview "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/components/maps/GoogleMapView.jsx"
click node_geoutils "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/utils/geoUtils.js"
click node_api_client "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/services/api.js"
click node_socket_client "https://github.com/developer-rudra/ridetogether_/blob/main/client/src/sockets/socket.js"
click node_express "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/app.js"
click node_authroutes "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/routes/authRoutes.js"
click node_authcontroller "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/controllers/authController.js"
click node_authguard "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/middleware/authMiddleware.js"
click node_userstore "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/models/User.js"
click node_token "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/utils/generateToken.js"
click node_health "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/controllers/healthController.js"
click node_rideroutes "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/routes/rideRoutes.js"
click node_ridecontroller "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/controllers/rideController.js"
click node_ridestore "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/models/Ride.js"
click node_memory "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/services/memoryStore.js"
click node_socketserver "https://github.com/developer-rudra/ridetogether_/blob/main/server/src/sockets/index.js"

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_authui,node_authpages,node_dashboard,node_create,node_join,node_lobby,node_map,node_mapview,node_geoutils,node_api_client,node_socket_client toneBlue
class node_express,node_authroutes,node_authcontroller,node_authguard,node_userstore,node_token,node_health,node_mongodb toneAmber
class node_rideroutes,node_ridecontroller,node_ridestore,node_memory toneMint
class node_socketserver,node_live_state toneRose
class node_rider,node_googlemaps,node_phone toneIndigo
```

## Components

### Rider app

- [App routing](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Auth context](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Login and register](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Ride dashboard](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Create ride](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/CreateRide.jsx): `client/src/pages/CreateRide.jsx`
- [Join ride](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/JoinRide.jsx): `client/src/pages/JoinRide.jsx`
- [Ride lobby](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/RideLobby.jsx): `client/src/pages/RideLobby.jsx`
- [Shared ride map](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/pages/RideMap.jsx): `client/src/pages/RideMap.jsx`
- [Map rendering](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/components/maps/GoogleMapView.jsx): `client/src/components/maps/GoogleMapView.jsx`
- [Location calculations](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/utils/geoUtils.js): `client/src/utils/geoUtils.js`
- [HTTP client](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Socket client](https://github.com/developer-rudra/ridetogether_/blob/main/client/src/sockets/socket.js): `client/src/sockets/socket.js`

### REST and identity

- [Express API](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/app.js): `server/src/app.js`
- [Auth routes](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Account operations](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [JWT guard](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/middleware/authMiddleware.js): `server/src/middleware/authMiddleware.js`
- [User records](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/models/User.js): `server/src/models/User.js`
- [JWT cookie](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/utils/generateToken.js): `server/src/utils/generateToken.js`
- [Health endpoint](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/controllers/healthController.js): `server/src/controllers/healthController.js`

### Ride management

- [Ride routes](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/routes/rideRoutes.js): `server/src/routes/rideRoutes.js`
- [Ride operations](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/controllers/rideController.js): `server/src/controllers/rideController.js`
- [Ride records](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/models/Ride.js): `server/src/models/Ride.js`
- [Memory fallback](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/services/memoryStore.js): `server/src/services/memoryStore.js`

### Live coordination

- [Socket.IO server](https://github.com/developer-rudra/ridetogether_/blob/main/server/src/sockets/index.js): `server/src/sockets/index.js`
- **Live ride state**

### Other components

- **Rider**
- **Google Maps**
- **Phone service**
- **MongoDB**

## Connections

- Rider → App routing: uses (evidence: `client/src/App.jsx`)
- App routing → Auth context: provides auth (evidence: `client/src/App.jsx`)
- App routing → Login and register: routes to (evidence: `client/src/App.jsx`)
- App routing → Ride dashboard: routes to (evidence: `client/src/App.jsx`)
- App routing → Create ride: routes to (evidence: `client/src/App.jsx`)
- App routing → Join ride: routes to (evidence: `client/src/App.jsx`)
- App routing → Ride lobby: routes to (evidence: `client/src/App.jsx`)
- App routing → Shared ride map: routes to (evidence: `client/src/App.jsx`)
- Login and register → Auth context: authenticates through (evidence: `client/src/context/AuthContext.jsx`)
- Auth context → HTTP client: calls (evidence: `client/src/context/AuthContext.jsx`)
- Ride dashboard → HTTP client: loads rides (evidence: `client/src/pages/Dashboard.jsx`)
- Create ride → HTTP client: creates rides (evidence: `client/src/pages/CreateRide.jsx`)
- Join ride → HTTP client: joins rides (evidence: `client/src/pages/JoinRide.jsx`)
- Ride lobby → HTTP client: loads ride (evidence: `client/src/pages/RideLobby.jsx`)
- Shared ride map → HTTP client: loads and ends ride (evidence: `client/src/pages/RideMap.jsx`)
- Shared ride map → Socket client: exchanges live events (evidence: `client/src/pages/RideMap.jsx`)
- Shared ride map → Map rendering: renders map (evidence: `client/src/pages/RideMap.jsx`)
- Shared ride map → Location calculations: calculates distances (evidence: `client/src/pages/RideMap.jsx`)
- Map rendering → Google Maps: displays map (evidence: `README.md`)
- Shared ride map → Phone service: offers rider calls (evidence: `client/src/pages/RideMap.jsx`)
- HTTP client → Express API: sends REST requests (evidence: `README.md`)
- Express API → Auth routes: mounts (evidence: `server/src/app.js`)
- Express API → Ride routes: mounts (evidence: `server/src/app.js`)
- Express API → Health endpoint: mounts health routes (evidence: `server/src/app.js`)
- Auth routes → Account operations: dispatches (evidence: `server/src/routes/authRoutes.js`)
- Auth routes → JWT guard: protects routes (evidence: `server/src/routes/authRoutes.js`)
- Account operations → User records: reads and writes (evidence: `server/src/controllers/authController.js`)
- Account operations → Memory fallback: falls back to (evidence: `server/src/controllers/authController.js`)
- Account operations → JWT cookie: sets token cookie (evidence: `server/src/controllers/authController.js`)
- JWT guard → User records: loads user (evidence: `server/src/middleware/authMiddleware.js`)
- JWT guard → Memory fallback: falls back to (evidence: `server/src/middleware/authMiddleware.js`)
- Ride routes → JWT guard: requires auth (evidence: `server/src/routes/rideRoutes.js`)
- Ride routes → Ride operations: dispatches (evidence: `server/src/routes/rideRoutes.js`)
- Ride operations → Ride records: reads and writes (evidence: `server/src/controllers/rideController.js`)
- Ride operations → Memory fallback: falls back to (evidence: `server/src/controllers/rideController.js`)
- Ride records → MongoDB: persists via Mongoose (evidence: `README.md`)
- Socket client → Socket.IO server: connects live (evidence: `README.md`)
- Socket.IO server → Live ride state: maintains rider state (evidence: `README.md`)
- Socket.IO server → Ride records: checks ride membership (evidence: `README.md`)
