# tinytechnicaltutorials/wildrydes-site architecture

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

- Interactive diagram: https://gitdiagram.com/tinytechnicaltutorials/wildrydes-site
- Repository: https://github.com/tinytechnicaltutorials/wildrydes-site

## Overview

Wild Rydes is a browser-based unicorn ride-sharing application. Its main workflow is account registration and verification, sign-in, pickup selection on a map, an authenticated ride request, and arrival feedback. The repository contains the browser application; the README describes the AWS API, Lambda, and DynamoDB backend, with the Lambda implementation included only as README code, not as a source file. The graph preserves the documented information pages and investor/application pages. Backend connections are based on README documentation; no backend source files are present in the tree.

Main entry points: [`js/ride.js`](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/ride.js) (Ride request client), [`js/esri-map.js`](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/esri-map.js) (Pickup map), [`js/cognito-auth.js`](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/cognito-auth.js) (Cognito authentication), [`README.md`](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/README.md) (Ride handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_home["Home page<br/>[index.html]"]
  node_info["Information pages<br/>[faq.html]"]
  node_investor["Investor page<br/>[investors.html]"]
  node_applications["Apply and join<br/>[apply.html]"]
  node_site_ui["Site interactions<br/>[main.js]"]
  node_vendor["Browser libraries<br/>[vendor.js]"]
  node_config["Client configuration<br/>[config.js]"]
end

subgraph group_identity["Account identity"]
  node_registration["Registration page<br/>[register.html]"]
  node_signin["Sign-in page<br/>[signin.html]"]
  node_verification["Verification page<br/>[verify.html]"]
  node_auth["Cognito authentication<br/>[cognito-auth.js]"]
  node_cognito["Amazon Cognito"]
end

subgraph group_ride["Ride experience"]
  node_ride_page["Ride page<br/>[ride.html]"]
  node_ride_client["Ride request client<br/>[ride.js]"]
  node_map["Pickup map<br/>[esri-map.js]"]
  node_arcgis["ArcGIS map service"]
end

subgraph group_backend["Ride backend"]
  node_api["API Gateway"]
  node_lambda["Ride handler<br/>[README.md]"]
  node_rides[("Rides table")]
end

node_rider(("Rider"))

node_rider -->|"opens"| node_home
node_rider -->|"registers"| node_registration
node_rider -->|"signs in"| node_signin
node_rider -->|"requests ride"| node_ride_page
node_rider -->|"visits"| node_info
node_rider -->|"visits"| node_investor
node_rider -->|"visits"| node_applications
node_auth -->|"reads settings"| node_config
node_ride_client -->|"reads settings"| node_config
node_auth -->|"authenticates"| node_cognito
node_ride_client -->|"reads token"| node_auth
node_ride_client -->|"reads pickup"| node_map
node_map -->|"signals pickup"| node_ride_client
node_map -->|"renders map"| node_arcgis
node_ride_client -->|"posts ride"| node_api
node_api -->|"routes request"| node_lambda
node_lambda -->|"writes ride"| node_rides

click node_home "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/index.html"
click node_info "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/faq.html"
click node_investor "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/investors.html"
click node_applications "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/apply.html"
click node_site_ui "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/main.js"
click node_vendor "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/vendor.js"
click node_config "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/config.js"
click node_registration "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/register.html"
click node_signin "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/signin.html"
click node_verification "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/verify.html"
click node_auth "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/cognito-auth.js"
click node_ride_page "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/ride.html"
click node_ride_client "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/ride.js"
click node_map "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/esri-map.js"
click node_lambda "https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/README.md"

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_home,node_info,node_investor,node_applications,node_site_ui,node_vendor,node_config toneBlue
class node_registration,node_signin,node_verification,node_auth,node_cognito toneAmber
class node_ride_page,node_ride_client,node_map,node_arcgis toneMint
class node_api,node_lambda,node_rides toneRose
class node_rider toneIndigo
```

## Components

### Web experience

- [Home page](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/index.html): `index.html`
- [Information pages](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/faq.html): `faq.html`
- [Investor page](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/investors.html): `investors.html`
- [Apply and join](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/apply.html): `apply.html`
- [Site interactions](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/main.js): `js/main.js`
- [Browser libraries](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/vendor.js): `js/vendor.js`
- [Client configuration](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/config.js): `js/config.js`

### Account identity

- [Registration page](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/register.html): `register.html`
- [Sign-in page](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/signin.html): `signin.html`
- [Verification page](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/verify.html): `verify.html`
- [Cognito authentication](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/cognito-auth.js): `js/cognito-auth.js`
- **Amazon Cognito**

### Ride experience

- [Ride page](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/ride.html): `ride.html`
- [Ride request client](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/ride.js): `js/ride.js`
- [Pickup map](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/js/esri-map.js): `js/esri-map.js`
- **ArcGIS map service**

### Ride backend

- **API Gateway**
- [Ride handler](https://github.com/tinytechnicaltutorials/wildrydes-site/blob/main/README.md): `README.md`
- **Rides table**

### Other components

- **Rider**

## Connections

- Rider → Home page: opens (evidence: `README.md`)
- Rider → Registration page: registers (evidence: `README.md`)
- Rider → Sign-in page: signs in (evidence: `README.md`)
- Rider → Ride page: requests ride (evidence: `README.md`)
- Rider → Information pages: visits
- Rider → Investor page: visits
- Rider → Apply and join: visits
- Cognito authentication → Client configuration: reads settings (evidence: `js/cognito-auth.js`)
- Ride request client → Client configuration: reads settings (evidence: `js/ride.js`)
- Cognito authentication → Amazon Cognito: authenticates (evidence: `js/cognito-auth.js`)
- Ride request client → Cognito authentication: reads token (evidence: `js/ride.js`)
- Ride request client → Pickup map: reads pickup (evidence: `js/ride.js`)
- Pickup map → Ride request client: signals pickup (evidence: `js/esri-map.js`)
- Pickup map → ArcGIS map service: renders map (evidence: `README.md`)
- Ride request client → API Gateway: posts ride (evidence: `js/ride.js`)
- API Gateway → Ride handler: routes request (evidence: `README.md`)
- Ride handler → Rides table: writes ride (evidence: `README.md`)
