# eitaar/yot-client architecture

> Architecture diagram of the GitHub repository eitaar/yot-client, 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/eitaar/yot-client
- Repository: https://github.com/eitaar/yot-client

## Overview

yot-client is a read-oriented mobile calendar for a self-hosted yot server. Users pair a device, then browse a cached calendar, upcoming events, and feed layouts; SSE and manual pulls keep event data current. Separate branches provide local Ask queries, demo Tracking, plugin-driven views, and display settings. The graph follows documented behavior and SOURCE INDEX references; unsampled routes and runtime wiring are left unconnected where their calls are not evidenced.

Main entry points: [`src/api/client.ts`](https://github.com/eitaar/yot-client/blob/main/src/api/client.ts) (REST client), [`src/store/events.ts`](https://github.com/eitaar/yot-client/blob/main/src/store/events.ts) (Events store), [`app/(tabs)/feed.tsx`](https://github.com/eitaar/yot-client/blob/main/app/(tabs)/feed.tsx) (Feed screen), [`src/plugins/loader.ts`](https://github.com/eitaar/yot-client/blob/main/src/plugins/loader.ts) (Plugin loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_calendar["Day calendar<br/>[index.tsx]"]
  node_upcoming["Upcoming events<br/>[events.tsx]"]
  node_eventdetail["Event detail<br/>[&#91;id&#93;.tsx]"]
  node_feedroute["Feed screen<br/>[feed.tsx]"]
  node_settings["Settings<br/>[settings.tsx]"]
  node_onboarding["Pairing setup<br/>[onboarding.tsx]"]
  node_trackingdetail["Tracking detail<br/>[&#91;id&#93;.tsx]"]
end

subgraph group_sync["Pairing and sync"]
  node_apiclient["REST client<br/>[client.ts]"]
  node_session["Session storage<br/>[session.ts]"]
  node_livesync["Live sync hook<br/>[useLiveSync.ts]"]
  node_sse["Event stream<br/>[sse.ts]"]
end

subgraph group_domain["Calendar data"]
  node_eventstate["Events store<br/>[events.ts]"]
  node_trackingstate["Tracking store<br/>[tracking.ts]"]
  node_settingsstate["Preferences store<br/>[settings.ts]"]
  node_eventmodel["Event model<br/>[types.ts]"]
  node_dates["Date utilities<br/>[dates.ts]"]
  node_daylayout["Timeline geometry<br/>[layoutDay.ts]"]
end

subgraph group_feed["Feed and plugins"]
  node_ask["Local Ask<br/>[AskView.tsx]"]
  node_feedlayouts["Feed layouts<br/>[DynamicFeed.tsx]"]
  node_trackingview["Tracking view<br/>[TrackingView.tsx]"]
  node_pluginpicker["Plugin picker<br/>[PluginPicker.tsx]"]
  node_pluginloader["Plugin loader<br/>[loader.ts]"]
  node_pluginrender["Plugin renderer<br/>[renderer.tsx]"]
  node_pluginactions["Plugin actions<br/>[actions.ts]"]
  node_pluginstate["Plugin state<br/>[plugins.ts]"]
end

subgraph group_platform["Local platform"]
  node_localstorage[("Device persistence<br/>[storage.ts]")]
end

node_user(("Calendar user"))
node_server["yot server"]
node_keychain[("OS secure storage")]

node_user -->|"browses"| node_calendar
node_user -->|"pairs device"| node_onboarding
node_user -->|"browses"| node_feedroute
node_calendar -->|"reads events"| node_eventstate
node_calendar -->|"formats dates"| node_dates
node_calendar -->|"lays out timeline"| node_daylayout
node_eventdetail -->|"updates events"| node_eventstate
node_eventdetail -->|"calls API"| node_apiclient
node_upcoming -.->|"reads events"| node_eventstate
node_feedroute -->|"renders"| node_ask
node_feedroute -->|"renders"| node_feedlayouts
node_feedroute -->|"renders"| node_trackingview
node_feedroute -->|"reads events"| node_eventstate
node_feedroute -->|"reads preferences"| node_settingsstate
node_feedroute -->|"reads tracking"| node_trackingstate
node_ask -->|"queries schedule"| node_eventstate
node_ask -->|"formats dates"| node_dates
node_ask -->|"queries schedule"| node_daylayout
node_pluginpicker -->|"updates selection"| node_pluginstate
node_onboarding -->|"renders"| node_pluginpicker
node_onboarding -->|"loads plugins"| node_pluginloader
node_onboarding -->|"pairs"| node_apiclient
node_settings -->|"updates preferences"| node_settingsstate
node_settings -->|"disconnects"| node_apiclient
node_trackingdetail -->|"loads specification"| node_pluginloader
node_trackingdetail -->|"renders view"| node_pluginrender
node_trackingdetail -->|"dispatches actions"| node_pluginactions
node_pluginloader -->|"fetches plugins"| node_apiclient
node_pluginloader -->|"updates tracking"| node_trackingstate
node_pluginloader -->|"caches specs"| node_localstorage
node_pluginrender -->|"renders catalog"| node_pluginstate
node_pluginactions -->|"calls API"| node_apiclient
node_pluginactions -->|"updates tracking"| node_trackingstate
node_eventstate -->|"syncs and mutates"| node_apiclient
node_eventstate -->|"caches snapshot"| node_localstorage
node_eventstate -->|"normalizes events"| node_eventmodel
node_settingsstate -->|"persists preferences"| node_localstorage
node_trackingstate -->|"persists tracking"| node_localstorage
node_livesync -->|"subscribes"| node_sse
node_livesync -->|"refreshes events"| node_eventstate
node_sse -->|"receives updates"| node_server
node_apiclient -->|"sends requests"| node_server
node_apiclient -->|"loads credentials"| node_session
node_apiclient -->|"saves paired session"| node_session
node_session -->|"stores API key"| node_keychain

click node_calendar "https://github.com/eitaar/yot-client/blob/main/app/(tabs)/index.tsx"
click node_upcoming "https://github.com/eitaar/yot-client/blob/main/app/(tabs)/events.tsx"
click node_eventdetail "https://github.com/eitaar/yot-client/blob/main/app/event/%5Bid%5D.tsx"
click node_feedroute "https://github.com/eitaar/yot-client/blob/main/app/(tabs)/feed.tsx"
click node_settings "https://github.com/eitaar/yot-client/blob/main/app/settings.tsx"
click node_onboarding "https://github.com/eitaar/yot-client/blob/main/app/onboarding.tsx"
click node_trackingdetail "https://github.com/eitaar/yot-client/blob/main/app/tracking/%5Bid%5D.tsx"
click node_ask "https://github.com/eitaar/yot-client/blob/main/src/components/feed/AskView.tsx"
click node_feedlayouts "https://github.com/eitaar/yot-client/blob/main/src/components/feed/DynamicFeed.tsx"
click node_trackingview "https://github.com/eitaar/yot-client/blob/main/src/components/feed/TrackingView.tsx"
click node_pluginpicker "https://github.com/eitaar/yot-client/blob/main/src/components/feed/PluginPicker.tsx"
click node_pluginloader "https://github.com/eitaar/yot-client/blob/main/src/plugins/loader.ts"
click node_pluginrender "https://github.com/eitaar/yot-client/blob/main/src/plugins/renderer.tsx"
click node_pluginactions "https://github.com/eitaar/yot-client/blob/main/src/plugins/actions.ts"
click node_pluginstate "https://github.com/eitaar/yot-client/blob/main/src/store/plugins.ts"
click node_eventstate "https://github.com/eitaar/yot-client/blob/main/src/store/events.ts"
click node_trackingstate "https://github.com/eitaar/yot-client/blob/main/src/store/tracking.ts"
click node_settingsstate "https://github.com/eitaar/yot-client/blob/main/src/store/settings.ts"
click node_eventmodel "https://github.com/eitaar/yot-client/blob/main/src/api/types.ts"
click node_dates "https://github.com/eitaar/yot-client/blob/main/src/lib/dates.ts"
click node_daylayout "https://github.com/eitaar/yot-client/blob/main/src/lib/layoutDay.ts"
click node_apiclient "https://github.com/eitaar/yot-client/blob/main/src/api/client.ts"
click node_session "https://github.com/eitaar/yot-client/blob/main/src/api/session.ts"
click node_livesync "https://github.com/eitaar/yot-client/blob/main/src/hooks/useLiveSync.ts"
click node_sse "https://github.com/eitaar/yot-client/blob/main/src/api/sse.ts"
click node_localstorage "https://github.com/eitaar/yot-client/blob/main/src/store/storage.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_calendar,node_upcoming,node_eventdetail,node_feedroute,node_settings,node_onboarding,node_trackingdetail,node_user toneBlue
class node_apiclient,node_session,node_livesync,node_sse,node_keychain toneAmber
class node_eventstate,node_trackingstate,node_settingsstate,node_eventmodel,node_dates,node_daylayout,node_server toneMint
class node_ask,node_feedlayouts,node_trackingview,node_pluginpicker,node_pluginloader,node_pluginrender,node_pluginactions,node_pluginstate toneRose
class node_localstorage toneIndigo
```

## Components

### App experience

- [Day calendar](https://github.com/eitaar/yot-client/blob/main/app/(tabs)/index.tsx): `app/(tabs)/index.tsx`
- [Upcoming events](https://github.com/eitaar/yot-client/blob/main/app/(tabs)/events.tsx): `app/(tabs)/events.tsx`
- [Event detail](https://github.com/eitaar/yot-client/blob/main/app/event/%5Bid%5D.tsx): `app/event/[id].tsx`
- [Feed screen](https://github.com/eitaar/yot-client/blob/main/app/(tabs)/feed.tsx): `app/(tabs)/feed.tsx`
- [Settings](https://github.com/eitaar/yot-client/blob/main/app/settings.tsx): `app/settings.tsx`
- [Pairing setup](https://github.com/eitaar/yot-client/blob/main/app/onboarding.tsx): `app/onboarding.tsx`
- [Tracking detail](https://github.com/eitaar/yot-client/blob/main/app/tracking/%5Bid%5D.tsx): `app/tracking/[id].tsx`

### Pairing and sync

- [REST client](https://github.com/eitaar/yot-client/blob/main/src/api/client.ts): `src/api/client.ts`
- [Session storage](https://github.com/eitaar/yot-client/blob/main/src/api/session.ts): `src/api/session.ts`
- [Live sync hook](https://github.com/eitaar/yot-client/blob/main/src/hooks/useLiveSync.ts): `src/hooks/useLiveSync.ts`
- [Event stream](https://github.com/eitaar/yot-client/blob/main/src/api/sse.ts): `src/api/sse.ts`

### Calendar data

- [Events store](https://github.com/eitaar/yot-client/blob/main/src/store/events.ts): `src/store/events.ts`
- [Tracking store](https://github.com/eitaar/yot-client/blob/main/src/store/tracking.ts): `src/store/tracking.ts`
- [Preferences store](https://github.com/eitaar/yot-client/blob/main/src/store/settings.ts): `src/store/settings.ts`
- [Event model](https://github.com/eitaar/yot-client/blob/main/src/api/types.ts): `src/api/types.ts`
- [Date utilities](https://github.com/eitaar/yot-client/blob/main/src/lib/dates.ts): `src/lib/dates.ts`
- [Timeline geometry](https://github.com/eitaar/yot-client/blob/main/src/lib/layoutDay.ts): `src/lib/layoutDay.ts`

### Feed and plugins

- [Local Ask](https://github.com/eitaar/yot-client/blob/main/src/components/feed/AskView.tsx): `src/components/feed/AskView.tsx`
- [Feed layouts](https://github.com/eitaar/yot-client/blob/main/src/components/feed/DynamicFeed.tsx): `src/components/feed/DynamicFeed.tsx`
- [Tracking view](https://github.com/eitaar/yot-client/blob/main/src/components/feed/TrackingView.tsx): `src/components/feed/TrackingView.tsx`
- [Plugin picker](https://github.com/eitaar/yot-client/blob/main/src/components/feed/PluginPicker.tsx): `src/components/feed/PluginPicker.tsx`
- [Plugin loader](https://github.com/eitaar/yot-client/blob/main/src/plugins/loader.ts): `src/plugins/loader.ts`
- [Plugin renderer](https://github.com/eitaar/yot-client/blob/main/src/plugins/renderer.tsx): `src/plugins/renderer.tsx`
- [Plugin actions](https://github.com/eitaar/yot-client/blob/main/src/plugins/actions.ts): `src/plugins/actions.ts`
- [Plugin state](https://github.com/eitaar/yot-client/blob/main/src/store/plugins.ts): `src/store/plugins.ts`

### Local platform

- [Device persistence](https://github.com/eitaar/yot-client/blob/main/src/store/storage.ts): `src/store/storage.ts`

### Other components

- **Calendar user**
- **yot server**
- **OS secure storage**

## Connections

- Calendar user → Day calendar: browses (evidence: `README.md`)
- Calendar user → Pairing setup: pairs device (evidence: `README.md`)
- Calendar user → Feed screen: browses (evidence: `README.md`)
- Day calendar → Events store: reads events (evidence: `app/(tabs)/index.tsx`)
- Day calendar → Date utilities: formats dates (evidence: `app/(tabs)/index.tsx`)
- Day calendar → Timeline geometry: lays out timeline (evidence: `app/(tabs)/index.tsx`)
- Event detail → Events store: updates events (evidence: `app/event/[id].tsx`)
- Event detail → REST client: calls API (evidence: `app/event/[id].tsx`)
- Upcoming events → Events store: reads events
- Feed screen → Local Ask: renders (evidence: `app/(tabs)/feed.tsx`)
- Feed screen → Feed layouts: renders (evidence: `app/(tabs)/feed.tsx`)
- Feed screen → Tracking view: renders (evidence: `app/(tabs)/feed.tsx`)
- Feed screen → Events store: reads events (evidence: `app/(tabs)/feed.tsx`)
- Feed screen → Preferences store: reads preferences (evidence: `app/(tabs)/feed.tsx`)
- Feed screen → Tracking store: reads tracking (evidence: `app/(tabs)/feed.tsx`)
- Local Ask → Events store: queries schedule (evidence: `src/components/feed/AskView.tsx`)
- Local Ask → Date utilities: formats dates (evidence: `src/components/feed/AskView.tsx`)
- Local Ask → Timeline geometry: queries schedule
- Plugin picker → Plugin state: updates selection (evidence: `src/components/feed/PluginPicker.tsx`)
- Pairing setup → Plugin picker: renders (evidence: `app/onboarding.tsx`)
- Pairing setup → Plugin loader: loads plugins (evidence: `app/onboarding.tsx`)
- Pairing setup → REST client: pairs (evidence: `app/onboarding.tsx`)
- Settings → Preferences store: updates preferences (evidence: `app/settings.tsx`)
- Settings → REST client: disconnects (evidence: `app/settings.tsx`)
- Tracking detail → Plugin loader: loads specification (evidence: `app/tracking/[id].tsx`)
- Tracking detail → Plugin renderer: renders view (evidence: `app/tracking/[id].tsx`)
- Tracking detail → Plugin actions: dispatches actions (evidence: `app/tracking/[id].tsx`)
- Plugin loader → REST client: fetches plugins (evidence: `src/plugins/loader.ts`)
- Plugin loader → Tracking store: updates tracking (evidence: `src/plugins/loader.ts`)
- Plugin loader → Device persistence: caches specs
- Plugin renderer → Plugin state: renders catalog (evidence: `src/plugins/renderer.tsx`)
- Plugin actions → REST client: calls API (evidence: `src/plugins/actions.ts`)
- Plugin actions → Tracking store: updates tracking (evidence: `src/plugins/actions.ts`)
- Events store → REST client: syncs and mutates (evidence: `src/store/events.ts`)
- Events store → Device persistence: caches snapshot (evidence: `src/store/events.ts`)
- Events store → Event model: normalizes events (evidence: `src/store/events.ts`)
- Preferences store → Device persistence: persists preferences (evidence: `src/store/settings.ts`)
- Tracking store → Device persistence: persists tracking (evidence: `src/store/tracking.ts`)
- Live sync hook → Event stream: subscribes (evidence: `src/hooks/useLiveSync.ts`)
- Live sync hook → Events store: refreshes events (evidence: `src/hooks/useLiveSync.ts`)
- Event stream → yot server: receives updates (evidence: `README.md`)
- REST client → yot server: sends requests (evidence: `README.md`)
- REST client → Session storage: loads credentials (evidence: `src/api/client.ts`)
- REST client → Session storage: saves paired session (evidence: `src/api/client.ts`)
- Session storage → OS secure storage: stores API key (evidence: `README.md`)
