# pseudoblessings/oahu-transit-app architecture

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

- Interactive diagram: https://gitdiagram.com/pseudoblessings/oahu-transit-app
- Repository: https://github.com/pseudoblessings/oahu-transit-app

## Overview

This repository is a minimal Oahu Transit mobile-app scaffold, not yet a transit-information product: the visible client workflow opens a HoloCard sign-in page in a WebView, captures a cookie containing a JWT, stores it in shared context, and displays the session on the home screen. The Express server exposes only a health-style root response. The README names the product but documents no further capabilities; the graph reflects only the shown implementation.

Main entry points: [`client/contexts/holoauthcontext.tsx`](https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/contexts/holoauthcontext.tsx) (Auth provider), [`client/app/index.tsx`](https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/app/index.tsx) (Session screen), [`client/app/_layout.tsx`](https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/app/_layout.tsx) (Root layout), [`server/src/index.ts`](https://github.com/pseudoblessings/oahu-transit-app/blob/main/server/src/index.ts) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile client"]
  node_root["Root layout<br/>[_layout.tsx]"]
  node_auth_provider["Auth provider"]
  node_home["Session screen<br/>[index.tsx]"]
end

subgraph group_auth["HoloCard sign-in"]
  node_holocard["HoloCard sign-in"]
end

subgraph group_server["API server"]
  node_api["Express API<br/>[index.ts]"]
end

node_user(("App user"))

node_root -->|"wraps app"| node_auth_provider
node_auth_provider -->|"loads sign-in"| node_holocard
node_holocard -->|"posts cookies"| node_auth_provider
node_auth_provider -.->|"provides session"| node_home
node_home -->|"reads context"| node_auth_provider
node_user -.->|"views session"| node_home
node_user -.->|"requests root"| node_api

click node_root "https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/app/_layout.tsx"
click node_auth_provider "https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/contexts/holoauthcontext.tsx"
click node_home "https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/app/index.tsx"
click node_api "https://github.com/pseudoblessings/oahu-transit-app/blob/main/server/src/index.ts"

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_root,node_auth_provider,node_home,node_user toneBlue
class node_holocard toneAmber
class node_api toneMint
```

## Components

### Mobile client

- [Root layout](https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/app/_layout.tsx): `client/app/_layout.tsx`
- [Auth provider](https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/contexts/holoauthcontext.tsx): `client/contexts/holoauthcontext.tsx`
- [Session screen](https://github.com/pseudoblessings/oahu-transit-app/blob/main/client/app/index.tsx): `client/app/index.tsx`

### HoloCard sign-in

- **HoloCard sign-in**

### API server

- [Express API](https://github.com/pseudoblessings/oahu-transit-app/blob/main/server/src/index.ts): `server/src/index.ts`

### Other components

- **App user**

## Connections

- Root layout → Auth provider: wraps app (evidence: `client/app/_layout.tsx`)
- Auth provider → HoloCard sign-in: loads sign-in (evidence: `client/contexts/holoauthcontext.tsx`)
- HoloCard sign-in → Auth provider: posts cookies (evidence: `client/contexts/holoauthcontext.tsx`)
- Auth provider → Session screen: provides session
- Session screen → Auth provider: reads context (evidence: `client/app/index.tsx`)
- App user → Session screen: views session
- App user → Express API: requests root
