Universal Habit Streak Widget

WHAT IT DOES

Universal Habit Streak Widget helps you build and maintain daily habits by tracking consecutive completion days. Define unlimited habits with custom names, mark them as complete with one click, and watch your streaks grow. The widget displays current streak counts, longest streaks achieved, weekly and monthly completion percentages, and a 30-day visual calendar showing every completed day. Streak milestone notifications celebrate your progress at 7-day intervals, keeping you motivated to maintain consistency.

WHERE IT RUNS

Works on any web page, making it the perfect companion for your daily routines. Whether you're working, studying, browsing, or using productivity tools, the widget stays accessible in a floating panel. It integrates seamlessly into any workflow without interrupting your focus.

HOW TO USE

Add habits by entering a name and clicking "Add Habit." Each habit appears in the list with its current streak count displayed. Click a habit to view detailed statistics including weekly and monthly completion rates, longest streak, and a 30-day calendar grid. Mark a habit as complete for today by clicking "Mark Done" in the details view. The calendar lets you backdate completions by clicking on any day cell. To remove a completion, click "Undo" or click a filled calendar cell to unmark it.

MECHANISM — STREAK CALCULATION WITH LOCAL STORAGE

The script tracks completions using a key-value system where each completion is stored as habitId_date. When calculating streaks, it checks today's completion and walks backward through consecutive days. This approach allows efficient querying of any date range without complex data structures. The streak calculation handles edge cases like missed days by resetting to zero, and the "longest streak" metric tracks the maximum consecutive days achieved. All data is stored locally using GM_setValue, providing instant access without network latency.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. Habit details, calendar views, and statistics are organized into clear sections for easy navigation. The interface uses a dark theme with accent colors to reduce eye strain.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all habit definitions, completions, and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only habit names and completion dates. You can reset all data at any time using the "Reset All Data" button. Streak notifications use GM_notification and require permission to display desktop notifications. Data persists across browser sessions and is isolated per browser profile.