🎯 ADHD Flow Desktop Widget — Setup & User Guide

Your custom, 100% free, offline-ready ADHD productivity widget is ready!

---

🌟 Key Features Built For You

1. 🧠 Smart Time-Blocking (FlowSavvy-style):

   • Visual daily timeline automatically schedules tasks.
   • Overdue Rescheduling: Click 🔄 or ⚡ Auto to shift overdue tasks forward without guilt.

2. 🪄 Magic Breakdown (Goblin.tools-style):

   • Click 🪄 on any intimidating task to explode it into tiny 5-minute micro-steps.
   • Works 100% offline with local rules, or connects to free Gemini AI if you provide an API key.

3. 📅 Google Calendar Sync:

   • Click 📅 Import in top-right to load any .ics file exported from Google Calendar.
   • Or configure Google Calendar integration in Settings to keep events handy.

4. 🔌 Integrations & Backup:

   • New plugin-style connectors let you configure GitHub, Google Calendar, and local backup in Settings.
   • Tasks, settings, and layout choices are saved locally and persist after install in the packaged app.

5. ❤️ Heart Mini Widget:

   • Floating pulsing heart button in the center panel. Click it to pop out a mini floating widget window!

6. ✨ Executive Function Support:

   • "What should I do next?": One-click AI / Rule recommendation to eliminate decision paralysis.
   • "Good Enough" Button: Complete tasks partially when perfectionism strikes.
   • Dopamine Animations & Streaks: Celebrate completed work with full confetti particle effects!

---

🖥️ How to Use as Desktop Wallpaper (Always Visible Behind Apps)

To place this widget directly on your Windows desktop background (behind all open windows):

1. Download Lively Wallpaper (Free & Open Source on Microsoft Store or GitHub).
2. Open Lively Wallpaper → click + Add Wallpaper.
3. Browse and select your index.html file (adhd-widget/index.html).
4. Click OK — your widget is now your desktop background!