Focus Planner
Local-first planning utility for calendar scheduling, task management, timer tracking, and browser-only analytics workflows.
Open utility
What it does
Focus Planner is a browser-based workspace for planning tasks on a calendar, running both task-linked and standalone timers, and reviewing time summaries without relying on a backend. The published build already includes dashboard, calendar, tasks, timers, analytics, and settings screens backed by local browser storage.
When to use it (and when not to)
Use it when:
- You want a private, browser-local planning tool instead of a cloud productivity suite.
- You need one place for calendar planning, task tracking, and focus timing.
- You want a project that is designed around recovery after refresh or browser restart.
- You want local backup export/import without setting up a server.
Avoid it when:
- You need shared calendars, team collaboration, or multi-user scheduling.
- You need production-ready cloud sync or third-party calendar integrations today.
- You need centralized admin controls or shared reporting across multiple users.
Inputs and outputs
Inputs
| Input | Description |
|---|---|
| Tasks and categories | Planned work items, categories, subtasks, and archive state stored locally. |
| Calendar selections | Day, week, month, or quarter planning views with scheduled task placement. |
| Timer actions | Start, pause, resume, stop, complete, and archive actions for task-linked or standalone timers. |
| Backup files | JSON import plus local export of backups, CSV data, and analytics reports. |
Outputs
| Output | Format | Notes |
|---|---|---|
| Planned schedule | On-screen | Calendar-based task layout for personal planning. |
| Session and timer history | Local records | Task sessions, timer state, and archive history stay in browser storage. |
| Analytics summaries | Dashboard / charts | Summaries by task, category, and time range. |
| Export files | Local file | Full backup JSON, tasks CSV, sessions CSV, and analytics report export. |
How to use
- Open the utility and create tasks from the dashboard or tasks page.
- Schedule work in the calendar using day, week, month, or quarter views.
- Start a task timer or create a standalone countdown/stopwatch from the timers page.
- Review progress in analytics and dashboard summaries.
- Use settings to export backups, CSV files, or restore a local JSON backup.
Example workflow: Create a Deep Work category, add a task for proposal writing, place it in the weekly calendar, start a linked timer, pause for interruption, resume, and then export your sessions report from settings.
- Expected output: A private planning flow with local persistence, timer recovery support, and analytics built around your own browser data.
Included views
- Dashboard with today focus totals and quick task creation.
- Calendar with day, week, month, and quarter planning views.
- Tasks workspace for active items, archived history, and category management.
- Timers page for standalone stopwatches and countdowns.
- Analytics summaries for focus distribution and progress.
- Settings page for appearance, time format, defaults, and data transfer.
Architecture notes
- The repository describes a modular layered SPA architecture with separate UI, application, domain, and data layers.
- IndexedDB, localStorage snapshots, and deterministic restoration are part of the planned persistence strategy.
- Timer recovery is treated as a first-class requirement, not an afterthought.
- The structure is meant to stay local-first now while remaining extensible for future sync features later.
Accuracy and verification
- This page reflects the currently published Focus Planner build and the local-first architecture visible in the repository.
- Data stays in browser storage, so clearing site data will remove local records unless you export a backup.
- Timer recovery depends on browser storage remaining available between reloads.
- If you extend the project, validate local persistence and timer restoration with manual refresh/restart tests.
FAQ
- Does Focus Planner need an account? No. The project is designed as a local-first browser utility with no required backend or authentication in the first version.
- Is data stored in the cloud? No cloud storage is planned for the initial version. Persistence is intended to stay local in browser storage.
- What views are planned? The utility includes dashboard, calendar, tasks, timers, analytics, and settings areas, with calendar views for day, week, month, and quarter planning.
- Can active timers recover after refresh? Yes. Timer recovery after refresh or browser restart is built into the app lifecycle and local storage strategy.
- Can I export or restore my local workspace? Yes. Settings include export options for backups, task and session CSV files, analytics reports, and JSON backup import.
Related tools
Changelog
- Initial publication on CAD AutoScript utility catalog.
Feedback / bug report
- Open a GitHub issue
- Email or DM with the slug
focus-plannerso we can reproduce the issue