PulseBreak — Hourly Wellness Desktop App

PulseBreak is a desktop app that reminds you every hour to take a short reset:

• Walk
• Stretch
• Breathe

Theme

Reset in 60 — a calm, lightweight wellness companion for busy workdays.

• Design language: minimal, non-intrusive, high-clarity
• Colors: Deep blue #1E3A8A, Teal #14B8A6, Soft gray #F3F4F6
• Tone: supportive and positive (never guilt-driven)

Current App Features

Core reminder engine

• Configurable interval (default: 60 minutes)
• Start/Stop controls
• Next reminder timestamp + live countdown in UI

Smart behavior

• Active-hours window (HH:MM to HH:MM) so reminders only fire during your schedule
• Snooze for 10 minutes
• Skip current reminder
• Dialog guard to prevent duplicate reminder windows

Break action flow

• Reminder dialog with one-click actions:
  • Walk
  • Stretch
  • Breathe
• Activity log panel with timestamps

Persistence

• Settings are saved to settings.json:
  • interval
  • active hours
  • last selected activity

Product Plan (Enhanced Version)

V1 (Completed baseline in this repo)

1. Hourly reminders
2. Walk/Stretch/Breathe action dialog
3. Snooze and skip flow
4. Saved user settings

V2 (Next)

1. System tray support with background mode
2. Optional reminder sounds
3. Daily/weekly streak tracker
4. Break duration presets (2/5/8 minutes)

V3 (Advanced)

1. AI-based suggestion timing
2. Calendar + focus-mode integration
3. Team wellness mode
4. Cross-device sync

Live links

• Repository: https://github.com/baargava/PulseBreak
• Live landing page (GitHub Pages): https://baargava.github.io/PulseBreak/

If the GitHub Pages URL is not live yet, enable it in Settings → Pages and set source to Deploy from a branch, branch master, folder /docs.

Run

python3 app.py

Verify syntax

python3 -m py_compile app.py