_{A live tour of TaskFlow — every screen, captured from the real app.}

---

✨ What is TaskFlow?

TaskFlow isn't a boring to-do list — it's a premium, gamified command center that lives on your desktop. Plan your day, crush your tasks, lock into deep focus, build habits and watch your XP climb, all in one fast, silky-smooth, offline-first app.

🎯 Plan Tasks with subtasks, tags, priorities, recurrence and reminders. Calendar, Kanban and a Ctrl+K command palette.

🔥 Execute Pomodoro Focus Mode, a habit tracker with a 90-day heatmap, and reminders that work even from the system tray.

🏆 Level up XP, levels, streaks and unlockable achievements — plus real analytics computed from your own data.

🔒 100% local-first. Everything lives in one JSON file on your machine. No accounts, no telemetry, no servers.

📸 Screenshots

Dashboard — live stats, completion, streak and your XP level at a glance.

Kanban — drag-and-drop columns, including custom ones you define.

Analytics — daily & weekly trends, completion rate, priority and category breakdowns.

🖼️ See more screens (Tasks, Calendar, Focus, Habits, Settings)

Tasks


Calendar


Focus Mode


Habits


Settings

🚀 Installation

Option A — Installer (recommended)

Download TaskFlow-Setup-<version>.exe, run it and follow the wizard. Choose your install directory and optionally add a desktop shortcut.

Option B — Portable

Download TaskFlow-Portable-<version>.exe and run it directly — no installation needed. Perfect for USB drives or locked-down machines.

Windows SmartScreen may warn about an unrecognized publisher since the app isn't signed with a paid certificate. Click More info → Run anyway.

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl + N	New Task
Ctrl + K	Command Palette / Search
Ctrl + ,	Open Settings
Ctrl + Enter	Save task (inside the task editor)
Esc	Close modal / palette
Alt + Ctrl + T	Show/hide TaskFlow globally

🧠 Feature Highlights

✅ Tasks	Title, description, category, priority, due date/time, reminders, recurrence, subtasks, tags, notes, time estimates. Confetti on completion (toggleable).
⏰ Reminders	Polled every 15 s from the main process — native Windows notifications with snooze, even when minimized to tray.
📅 Calendar	Month, week and day views. Drag a task to a new date to reschedule.
🗂️ Kanban	Backlog → To Do → In Progress → Completed, plus custom columns.
📊 Analytics	14-day trend, weekly bars, completion donut, priority & category breakdowns, estimated-vs-actual time.
🏆 Gamification	XP (more for high priority), levels, streaks and achievements like First Task, 7 Day Streak, Productivity Master. Optional.
🎯 Focus Mode	Configurable Pomodoro, current-task binding and an animated countdown ring.
🔥 Habits	Daily tracking, streaks and a 90-day GitHub-style heatmap.

🛠️ Development Setup

git clone <your-repo-url>
cd TaskFlow
npm install

Run in development (renderer + Electron):

npm run dev:vite       # terminal 1 — Vite dev server
npm run dev:electron   # terminal 2 — Electron pointed at the dev server

📦 Build Instructions

Build the renderer and package a Windows installer + portable exe:

npm run build:win

Output lands in dist/:

• TaskFlow-Setup-<version>.exe — NSIS installer
• TaskFlow-Portable-<version>.exe — portable executable

Build an unpacked directory only (faster, for local testing):

npm run build:win:dir

Cross-compiling the Windows build on Linux/macOS requires Wine (wine + 32-bit support) for the NSIS uninstaller stage. On Windows, no extra setup is needed.

The renderer never touches the filesystem directly — all persistence goes through window.taskflow (exposed via contextIsolation-safe preload.cjs) to the main-process Store class, which does atomic JSON writes to Electron's userData directory.

💾 Data Storage & Backup

All data — tasks, habits, settings, achievements — lives in a single local JSON file inside your Windows user data folder (%APPDATA%/TaskFlow/taskflow-data.json). Writes are atomic (write-to-temp-then-rename) to avoid corruption, and a corrupted file is backed up automatically rather than wiping your data.

Export: Settings → Data → Export JSON / Export CSV Import: Settings → Data → Import Backup (restores a previously exported JSON file)

🔒 Privacy

TaskFlow works fully offline. It does not collect analytics, does not phone home, and never transmits your tasks anywhere. There is no hidden telemetry of any kind.

♿ Accessibility

Full keyboard navigation, visible focus states, sufficient color contrast, a reduced-motion setting, and tooltips throughout. The app remains fully usable with animations disabled.

🩹 Troubleshooting

• Notifications aren't appearing — Check Windows Settings → Notifications → make sure TaskFlow is allowed to show notifications, and that Focus Assist isn't blocking them.
• App won't reopen from the tray — Left-click the tray icon; right-click opens the tray menu.
• SmartScreen warning on install — Expected for apps without a paid code-signing certificate. Click "More info → Run anyway."
• Data looks missing after an update — Check %APPDATA%/TaskFlow/ for taskflow-data.json and any .corrupt-* backup files.

🗺️ Roadmap

• Cloud sync (optional, opt-in)
• Mobile companion app
• Custom themes beyond dark / light / AMOLED
• Natural-language quick-add ("Call mom tomorrow 5pm")

🤝 Contributing

Issues and pull requests are welcome! Please open an issue describing the change before submitting large PRs.

📄 License

MIT — see LICENSE.

🙏 Built with

Electron · React · Vite · Tailwind CSS · Framer Motion · Recharts · Zustand · Lucide

---

_{If TaskFlow helps you get more done, a ⭐ is the best thank-you — it helps other people find it.
Bugs, ideas and feedback are just as welcome — open an issue anytime.}