How malasadongegg/trackhour works
TrackHour imports AI-chat exports locally, estimates usage sessions, and presents statistics or downloadable SVG cards. Optional account features save aggregate data for hosted cards; the browser extension and Claude Code hook provide additional measured-session inputs. The principal flow is documented in the README and partly visible in App.tsx; several component and endpoint relationships are documented but their implementation was not sampled.
Main entry points: App.tsx App workflow · handler.ts Card request handler · AccountPage.tsx Account page · CardControls.tsx Card designer
Components 27
Web app
- App workflow
web/src/App.tsx - Export intake
web/src/components/Dropzone.tsx - Import preview
web/src/components/ImportPreview.tsx - Browser library
web/src/lib/db.ts - IndexedDB
- Dashboard views
web/src/components/Heatmap.tsx - Account page
web/src/pages/AccountPage.tsx - Authentication
web/src/lib/useAuth.ts - Card designer
web/src/components/card/CardControls.tsx - Card preview
web/src/components/card/CardPreview.tsx
Usage core
- Export parsers
core/src/parse - Import reconciliation
core/src/importing.ts - Session estimation
core/src/sessionize.ts - Usage statistics
core/src/stats.ts - Date utilities
core/src/dates.ts - Heatmap intensity
core/src/heat.ts - SVG renderer
core/src/card/render.ts
Hosted cards
- Card API adapter
web/api/card.ts - Card request handler
card/src/handler.ts - Rate limiter
card/src/ratelimit.ts - Profile store
card/src/supabase.ts
Measured capture
- Browser tracker
extension/src/content-tracker.js - Extension worker
extension/src/background.js - Session tracking
extension/src/sessions.js - Claude Code hook
claude-code-hook/hook.mjs
Other components
- Visitor
- Supabase
Connections 29
- Visitor → Export intake: selects export
README.md - Export intake → App workflow: submits file
README.md - App workflow → Export parsers: parses locally
README.md - App workflow → Import preview: shows preview
README.md - App workflow → Import reconciliation: reconciles records
README.md - App workflow → Browser library: loads and saves
web/src/App.tsx - Browser library → IndexedDB: persists locally
README.md - App workflow → Session estimation: derives sessions
README.md - App workflow → Usage statistics: derives statistics
README.md - App workflow → Dashboard views: renders dashboard
web/src/App.tsx - Usage statistics → Date utilities: uses date helpers
core/src/stats.ts - Dashboard views → Heatmap intensity: uses intensity
- Visitor → Card designer: configures card
README.md - App workflow → Card designer: hosts designer
web/src/App.tsx - Card designer → Card preview: updates preview
README.md - Card preview → SVG renderer: renders SVG
README.md - Visitor → Account page: opens account
README.md - Account page → Authentication: uses authentication
web/src/pages/AccountPage.tsx - Authentication → Supabase: authenticates
web/src/lib/useAuth.ts - Account page → Supabase: saves aggregates
README.md - Visitor → Card API adapter: requests hosted card
README.md - Card API adapter → Card request handler: adapts request
README.md - Card request handler → Rate limiter: checks limits
card/src/handler.ts - Card request handler → Profile store: loads public profile
card/src/handler.ts - Card request handler → SVG renderer: renders card
card/src/handler.ts - Browser tracker → Extension worker: reports activity
- Extension worker → Session tracking: records beats
extension/src/background.js - Browser tracker → App workflow: imports session log
web/src/App.tsx - Claude Code hook → App workflow: imports session log