How sergio-deluich-kaufmann/traccio works
Traccio is a local desktop running log: a user selects a name-matched Excel workbook, then explores summaries from year to month to day. The main process loads runs and computes summaries, pace, calendar data, and estimated calories; the React renderer presents those results through a back-stack navigation flow. The README documents the process boundary and workbook workflow; sampled source confirms the data calculations, IPC handler ownership, and screen routing. Some screen-to-API calls are not visible in the excerpts, so links across that boundary rely on the README.
Main entry points: App.tsx App router · index.ts Typed preload bridge · ipcHandlers.ts IPC handlers · MonthDetailScreen.tsx Month detail
Components 18
Renderer experience
- Name verification
src/renderer/src/screens/UserVerificationScreen.tsx - Year selection
src/renderer/src/screens/YearSelectionScreen.tsx - Month selection
src/renderer/src/screens/MonthSelectionScreen.tsx - Month detail
src/renderer/src/screens/MonthDetailScreen.tsx - Day detail
src/renderer/src/screens/DayViewScreen.tsx - App router
src/renderer/src/App.tsx - Navigation stack
src/renderer/src/navigation/NavigationContext.tsx - Year grid
src/renderer/src/components/YearGrid.tsx - Month grid
src/renderer/src/components/MonthGrid.tsx - Activity calendar
src/renderer/src/components/CalendarGrid.tsx - Pace trend chart
src/renderer/src/components/PaceTrendChart.tsx - Theme controls
src/renderer/src/theme/ThemeContext.tsx
Desktop bridge
- Typed preload bridge
src/preload/index.ts - IPC handlers
src/main/ipcHandlers.ts
Run data domain
- Workbook analytics
src/main/dataService.ts
Local persistence
- Excel workbooks
data - Saved user name
src/main/userSettingsService.ts
Other components
- Runner
Connections 22
- Runner → Name verification: enters name
README.md - App router → Name verification: routes to
src/renderer/src/App.tsx - App router → Year selection: routes to
src/renderer/src/App.tsx - App router → Month selection: routes to
src/renderer/src/App.tsx - App router → Month detail: routes to
src/renderer/src/App.tsx - App router → Day detail: routes to
src/renderer/src/App.tsx - App router → Navigation stack: uses state
src/renderer/src/App.tsx - Year selection → Year grid: renders
src/renderer/src/screens/YearSelectionScreen.tsx - Month selection → Month grid: renders
src/renderer/src/screens/MonthSelectionScreen.tsx - Month detail → Activity calendar: renders
src/renderer/src/screens/MonthDetailScreen.tsx - Month detail → Pace trend chart: renders
src/renderer/src/screens/MonthDetailScreen.tsx - Name verification → Typed preload bridge: requests data
README.md - Year selection → Typed preload bridge: requests summaries
README.md - Month selection → Typed preload bridge: requests summaries
README.md - Month detail → Typed preload bridge: requests detail
README.md - Day detail → Typed preload bridge: requests detail
README.md - Typed preload bridge → IPC handlers: invokes IPC
README.md - IPC handlers → Workbook analytics: loads and queries
src/main/ipcHandlers.ts - IPC handlers → Saved user name: reads or writes
src/main/ipcHandlers.ts - Workbook analytics → Excel workbooks: reads workbook
src/main/dataService.ts - IPC handlers → Workbook analytics: returns results
src/main/ipcHandlers.ts - Workbook analytics → IPC handlers: returns summaries
src/main/ipcHandlers.ts