How zxch3n/pomodorologger works
Pomodoro Logger is a local-first desktop time-management app. A user starts a focus or rest session, associates focus with a Kanban board and its in-progress cards, and the app records desktop activity for later history and efficiency analysis. The renderer also supports board planning, data import/export, settings, and visual reports; Electron main-process code provides desktop services. Relationships are shown only where the README or sampled/indexed files support them; some monitoring, storage, and analysis internals were not excerpted.
Main entry points: Application.tsx Application UI · action.ts Pomodoro timer · History.tsx Session history · sessionManager.ts Session manager
Components 20
Desktop shell
- Application UI
src/renderer/components/Application.tsx - Electron main
src/main/main.ts - Desktop IPC
src/main/ipc/ipc.ts - Settings
src/renderer/components/Setting/Setting.tsx
Focus and activity
- Pomodoro timer
src/renderer/components/Timer/action.ts - Activity monitoring
src/renderer/monitor - Session manager
src/renderer/monitor/sessionManager.ts
Kanban planning
- Kanban board
src/renderer/components/Kanban/Kanban.tsx - Board actions
src/renderer/components/Kanban/Board/action.ts - Card actions
src/renderer/components/Kanban/Card/action.ts
History and data
- Session history
src/renderer/components/History/History.tsx - History actions
src/renderer/components/History/action.ts - Local data store
src/main/db.ts - Renderer database access
src/renderer/dbs.ts - Import and export
src/main/io - Data merger
src/shared/dataMerger/dataMerger.ts
Analysis and reports
- Efficiency analysis
src/shared/efficiency/efficiency.ts - Activity visualizations
src/renderer/components/Visualization - Pomodoro Sankey
src/renderer/components/Visualization/PomodoroSankey.tsx
Other components
- User
Connections 22
- User → Application UI: uses
- Application UI → Pomodoro timer: shows timer
src/renderer/components/Application.tsx - Application UI → Kanban board: shows board
src/renderer/components/Application.tsx - Application UI → Session history: shows history
src/renderer/components/Application.tsx - Application UI → Pomodoro Sankey: shows report
src/renderer/components/Application.tsx - User → Pomodoro timer: starts sessions
- Pomodoro timer → Session manager: saves session
src/renderer/components/Timer/action.ts - Pomodoro timer → Board actions: updates board
src/renderer/components/Timer/action.ts - Activity monitoring → Session manager: records activity
- Session manager → Local data store: persists records
- User → Kanban board: organizes tasks
- Board actions → Card actions: updates cards
src/renderer/components/Kanban/Board/action.ts - Session history → History actions: uses actions
src/renderer/components/History/index.ts - Application UI → Renderer database access: loads databases
src/renderer/components/Application.tsx - Renderer database access → Local data store: accesses store
src/renderer/dbs.ts - User → Import and export: imports or exports
- Import and export → Data merger: merges imported data
src/main/worker/dataHandlers.ts - Electron main → Desktop IPC: initializes desktop
src/main/main.ts - User → Efficiency analysis: reviews efficiency
- Session history → Activity visualizations: reviews activity
- Application UI → Efficiency analysis: uses analysis
- Application UI → Settings: opens settings