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