How iabolfazlmhm/focusapp works
FocusApp is a local-first Pomodoro timer, task manager, and habit tracker. The user enters through the app bootstrap, then works in the timer, task, and habit views; focus time and habit activity feed the progress dashboard. Settings and other views provide localization, help, quotes, data portability, and Trash. Shared state, browser storage, and reusable UI utilities support these workflows. Some feature modules were not excerpted, so their README-documented capabilities are included, but uncertain internal call paths are omitted.
Main entry points: main.js App bootstrap · timer.js Timer and focus · progress.js Progress dashboard · settings.js Settings and backup
Components 29
App entry
- App bootstrap
src/main.js - Settings and backup
src/features/settings/settings.js - Trash and restore
src/features/trash/trash.js - Trash interface
src/features/trash/trash-ui.js - Help guide
src/features/help/help.js
Focus and planning
- Timer and focus
src/features/timer/timer.js - Focus mode
src/features/timer/focus-mode.js - Task manager
src/features/tasks/tasks.js - Task rendering
src/features/tasks/tasks-render.js - Task persistence
src/features/tasks/tasks-storage.js - Habit tracker
src/features/habits/habits.js - Habit rendering
src/features/habits/habits-render.js - Habit scheduling
src/features/habits/habits-logic.js - Habit persistence
src/features/habits/habits-storage.js
Progress and content
- Progress dashboard
src/features/progress/progress.js - Activity heatmaps
src/features/progress/progress-heatmap.js - Daily report
src/features/progress/progress-report.js - Progress statistics
src/features/progress/progress-stats.js - Quotes
src/features/quotes/quotes.js - Motivation data
src/features/quotes/motivation.js
Shared platform
- Shared app state
src/core/state.js - Browser storage
src/core/storage.js - Localization
src/core/i18n.js - Date utilities
src/core/date-utils.js - DOM utilities
src/core/dom-utils.js - Audio engine
src/shared/audio.js - Toast notifications
src/shared/toast/toast.js - Shared UI widgets
src/shared
Other components
- User
Connections 36
- User → App bootstrap: opens app
README.md - App bootstrap → Timer and focus: initializes
src/main.js - App bootstrap → Task manager: initializes
src/main.js - App bootstrap → Habit tracker: initializes
src/main.js - App bootstrap → Progress dashboard: initializes
src/main.js - App bootstrap → Settings and backup: initializes
src/main.js - App bootstrap → Focus mode: initializes
src/main.js - App bootstrap → Quotes: initializes
src/main.js - Task manager → Task rendering: renders
src/features/tasks/tasks.js - Task manager → Task persistence: saves
src/features/tasks/tasks.js - Task manager → Trash and restore: soft-deletes
src/features/tasks/tasks.js - Task rendering → Task persistence: saves preferences
src/features/tasks/tasks-render.js - Timer and focus → Task persistence: saves focus time
src/features/timer/timer.js - Timer and focus → Task rendering: formats task time
src/features/timer/timer.js - Habit tracker → Habit rendering: renders
- Habit rendering → Habit scheduling: calculates cadence
src/features/habits/habits-render.js - Habit rendering → Habit persistence: reads data
src/features/habits/habits-render.js - Progress dashboard → Activity heatmaps: uses
src/features/progress/progress.js - Progress dashboard → Progress statistics: uses
src/features/progress/progress.js - Activity heatmaps → Daily report: opens report
src/features/progress/progress-heatmap.js - Activity heatmaps → Progress statistics: uses
src/features/progress/progress-heatmap.js - Settings and backup → Trash interface: opens
src/features/settings/settings.js - Trash interface → Trash and restore: manages items
src/features/trash/trash-ui.js - Quotes → Motivation data: uses
src/features/quotes/quotes.js - Settings and backup → Progress dashboard: updates preferences
src/features/settings/settings.js - Shared app state → Browser storage: loads state
src/core/state.js - Localization → Browser storage: loads locale
src/core/i18n.js - App bootstrap → Localization: initializes
src/main.js - Timer and focus → Shared app state: updates timer state
src/features/timer/timer.js - Timer and focus → Audio engine: plays sounds
src/features/timer/timer.js - Toast notifications → Audio engine: plays feedback
src/shared/toast/toast.js - Progress dashboard → Date utilities: uses dates
src/features/progress/progress.js - Help guide → Browser storage: saves help state
src/features/help/help.js - Settings and backup → Localization: switches language
src/features/settings/settings.js - Timer and focus → Browser storage: records timer data
src/features/timer/timer.js - Shared UI widgets → Date utilities: date picker uses
src/shared/date-nav/date-picker-popover.js