A desktop application and personal execution operating system that transforms long-term engineering and learning roadmaps into prioritized daily action items, adaptive schedules, stateful Pomodoro focus sessions, and privacy-first local activity tracking.
Built with Electron, React, TypeScript, Tailwind CSS, and sql.js (WebAssembly SQLite) with a bold Neo-Brutalist design aesthetic.
Adaptive daily task scheduling, real-time focus tracking vs targets, primary and secondary sequenced blocks, reason badges, and one-click recalculation.
Weekly Monday–Sunday historical breakdown comparing planned vs actual focus duration alongside completed and missed task statistics.
Full hierarchical roadmap visualizer (Phases ➔ Goals ➔ Milestones ➔ Tasks) with phase progress tracking, domain tags, priority indicators, and task completion.
Privacy-first foreground application monitoring comparing active focus sessions against overall computer activity with live classification donut charts and application categorization.
Comprehensive weekly reflection dashboard with calculated execution metrics, domain distributions, and customizable qualitative KPI logs.
Full control over daily work capacity, weekday/weekend availability, customizable Pomodoro durations & color themes, startup registration, desktop notifications, and atomic database backups.
- Zero-Friction Startup Generation: Today's schedule automatically generates on boot or app start—even in the background tray.
- Midnight Rollover Check: Detects calendar day changes in real-time when left running overnight and creates the fresh day's plan.
- Dynamic Recalculation: Adapt to changes on the fly with the [RECALCULATE PLAN] button. Deducts completed focus time and dynamically reschedules remaining capacity.
- Missed Task Recovery Engine: Tasks missed from previous days are detected. Critical path tasks receive priority boosts (+25 pts) while low-value maintenance tasks are safely deferred (-20 pts).
- Weekend Capacity Filter: Automatically respects your weekend schedule configuration.
- Always-on-Top Floating Widget: Minimalist, draggable floating timer overlay.
- Automated Pomodoro Loop: Transitions through
WORK➔SHORT BREAK➔WORK➔LONG BREAKbased on your configured session targets. - Multi-Theme Support:
Default(Neo Coral & Black)Blue / Green(High Contrast Electric)White / Yellow(Minimalist Cyber)Red / Green(Urgent Focus)
- Task Decoupling: Finishing a focus session logs your exact active focus time without automatically closing the task until you explicitly confirm completion.
- 100% Private & Local: Zero keystrokes, screenshots, or clipboard data captured. Only polls foreground application titles via
active-win. - Classification Engine: Sorts detected apps into
Productive,Neutral,Distracting, orIgnored. - Visual Distribution: Interactive donut charts and breakdown meters comparing focused study time vs ambient computer usage.
- Pre-seeded with a comprehensive multi-phase learning path (Foundations, Deep Learning, Reinforcement Learning, Advanced Architectures, Distributed Systems & MLOps, Research & Open Source).
- Enforces milestone sequencing and prerequisite dependencies.
- Built on
sql.js(WebAssembly SQLite), providing zero-native-dependency SQLite persistence on Windows, Linux, and macOS. - Atomic file writes using
.tmpstaging and safe disk rename routines to guarantee corruption-proof data safety. - One-click JSON exports and full SQLite DB backup/restore directly from the Settings UI.
├── electron/
│ ├── main.ts # Main process, window management, system tray, atomic DB persistence, IPC handlers
│ ├── scheduler.ts # Dynamic scoring algorithm, capacity budgeting, rollover & recovery logic
│ ├── tracker.ts # Active application tracking service & in-memory aggregator (active-win)
│ └── preload.ts # Secure context isolation bridge (window.api)
├── src/
│ ├── components/
│ │ ├── Dashboard.tsx # Execution dashboard, daily blocks & recalculator
│ │ ├── CalendarPage.tsx # Weekly execution history & schedule view
│ │ ├── Roadmap.tsx # Hierarchical 24-month roadmap tree
│ │ ├── TimePage.tsx # Time Analytics, app classifications & distribution charts
│ │ ├── WeeklyReview.tsx # Weekly review & KPI tracking
│ │ ├── FocusTimerOverlay.tsx # Frameless floating Pomodoro loop timer
│ │ ├── Settings.tsx # Preferences, timer themes, capacity & backups
│ │ └── ui/ # Reusable Neo-Brutalist design primitives (NeoCard, NeoButton, NeoBadge)
│ ├── db/
│ │ ├── schema.sql # Relational database schema
│ │ └── roadmap_data.json # Structured 24-month curriculum seed data
│ ├── App.tsx # Shell layout with torn-paper logo & routing
│ └── index.css # Custom Tailwind CSS Neo-Brutalist design tokens
- Node.js (v18.0.0 or higher recommended)
- npm (v9.0.0 or higher)
-
Clone the repository:
git clone https://github.com/Polymorph0us/productivity-app.git cd productivity-app -
Install dependencies:
npm install
-
Run in Development Mode:
npm run dev
This starts the Vite React dev server and launches Electron concurrently.
-
Build for Production:
npm run build
All preferences can be adjusted directly in the Settings view or via config.json in your OS user application data folder:
- Available Hours: Adjusts your daily budget (e.g. 2–8 hours).
- Pomodoro Durations: Customize Work (mins), Short Break (mins), and Long Break (mins).
- Theme Selection: Switch between timer overlay color schemes.
- Activity Tracking: Choose between tracking only during active focus sessions, always tracking, or turning tracker off.
- Startup Launch: Toggle automatic Windows startup via
app.setLoginItemSettings.
- Zero Cloud Dependencies: All schedules, logs, and activity metrics remain on your local machine in a standalone SQLite database.
- Zero Sensitive Data Logging: No keystroke loggers, screen captures, or URL scraping. Only application process names and top-level window titles are stored.
MIT License. Feel free to use, modify, and distribute for your own personal execution workflows!