How ahuryx/arc works
Arc is a cross-platform desktop widget app. Users launch it, control visibility and workspace preferences from the system tray or settings window, and view six independent widgets; settings and widget state are persisted and shared across windows. The map covers the host, workspace, settings, widget, and live-data layers. Some feed providers and native-host internals are unsampled, so their detailed runtime connections are omitted.
Main entry points: useAppState.ts App state hook · widgetRegistry.ts Widget registry · settings-app.tsx Settings window · workspaceHost.ts Workspace actions
Components 28
Desktop host
- Tauri host
src-tauri/src/lib.rs - Bootstrap
src/bootstrap.ts - Tray controls
src/core/trayController.ts - Widget entry
src/App.tsx - Widget shell
src/shell/widget-shell.tsx
Workspace core
- Workspace actions
src/core/workspaceHost.ts - Window manager
src/core/widgetManager.ts - Widget catalog
src/core/widgetCatalog.ts - Widget registry
src/core/widgetRegistry.ts - Widget lifecycle
src/core/useWidgetLifecycle.ts - Settings store
src/core/settingsStore.ts - App state hook
src/core/useAppState.ts - Theme
src/core/theme.ts
Settings
- Settings window
src/settings/settings-app.tsx - Crypto preferences
src/components/settings/crypto-settings-panel.tsx - Settings navigation
src/core/settingsNav.ts
Widgets
- Clock
src/widgets/clock/clock-widget.tsx - Calendar
src/widgets/calendar/calendar-widget.tsx - Crypto widget
src/widgets/crypto/crypto-widget.tsx - Weather widget
src/widgets/weather/weather-widget.tsx - Notes
src/widgets/notes/notes-widget.tsx - Pomodoro
src/widgets/pomodoro/pomodoro-widget.tsx - Calendar dates
src/lib/dates.ts
Live data
- Crypto feeds
src/feeds/crypto/cryptoFeed.ts - Weather feed
src/feeds/weatherFeed.ts - Live-feed hook
src/hooks/use-live-feed.ts - Live-feed core
src/core/liveFeed.ts
Other components
- User
Connections 39
- User → Tray controls: controls
README.md - User → Settings window: configures
README.md - Bootstrap → Tray controls: initializes
src/bootstrap.ts - Tray controls → Workspace actions: dispatches actions
src/core/trayController.ts - Workspace actions → Window manager: delegates windows
src/core/workspaceHost.ts - Workspace actions → Settings store: updates settings
src/core/workspaceHost.ts - Window manager → Settings store: reads and persists
src/core/widgetManager.ts - Window manager → Widget catalog: reads metadata
src/core/widgetManager.ts - Widget entry → Widget lifecycle: starts lifecycle
src/App.tsx - Widget entry → Widget registry: selects widget
src/App.tsx - Widget entry → Widget shell: renders
src/App.tsx - Widget registry → Clock: registers
src/core/widgetRegistry.ts - Widget registry → Calendar: registers
src/core/widgetRegistry.ts - Widget registry → Crypto widget: registers
src/core/widgetRegistry.ts - Widget registry → Weather widget: registers
src/core/widgetRegistry.ts - Widget registry → Notes: registers
src/core/widgetRegistry.ts - Widget registry → Pomodoro: registers
src/core/widgetRegistry.ts - Widget lifecycle → Window manager: coordinates windows
src/core/useWidgetLifecycle.ts - Settings window → App state hook: reads state
src/settings/settings-app.tsx - Settings window → Workspace actions: changes preferences
src/settings/settings-app.tsx - Settings window → Settings navigation: parses tabs
src/settings/settings-app.tsx - Settings window → Crypto preferences: renders crypto settings
src/settings/settings-app.tsx - Crypto preferences → Workspace actions: saves watchlist
src/components/settings/crypto-settings-panel.tsx - App state hook → Settings store: loads settings
src/core/useAppState.ts - App state hook → Theme: applies theme
src/core/useAppState.ts - Clock → App state hook: reads preferences
- Calendar → App state hook: reads preferences
src/widgets/calendar/calendar-widget.tsx - Calendar → Calendar dates: formats dates
src/widgets/calendar/calendar-widget.tsx - Crypto widget → App state hook: reads preferences
src/widgets/crypto/crypto-widget.tsx - Crypto widget → Live-feed hook: subscribes
src/widgets/crypto/crypto-widget.tsx - Crypto widget → Crypto feeds: requests prices
src/widgets/crypto/crypto-widget.tsx - Weather widget → App state hook: reads preferences
src/widgets/weather/weather-widget.tsx - Weather widget → Live-feed hook: subscribes
src/widgets/weather/weather-widget.tsx - Weather widget → Weather feed: requests conditions
src/widgets/weather/weather-widget.tsx - Live-feed hook → Live-feed core: uses feed core
src/hooks/use-live-feed.ts - Weather feed → Live-feed core: uses feed core
src/feeds/weatherFeed.ts - Notes → App state hook: reads preferences
src/widgets/notes/notes-widget.tsx - Pomodoro → App state hook: reads preferences
src/widgets/pomodoro/pomodoro-widget.tsx - Tauri host → Bootstrap: hosts frontend
README.md