Repository navigation
Releases
BreakMate v1.11.0
BreakMate v1.11.0
✨ New Features
- Add uninstall scripts for macOS, Windows, and Linux; update README and Homebrew cask
- Update CI workflows to use flutter-version.yaml for Flutter SDK versioning and add Linux/Windows installation scripts
- Add macOS installation script and update README with installation instructions
- Enhance overlay health check and add escape failsafe for improved user experience
- Update version to 1.11.0 and add entry to changelog for upcoming release
- Improve error message for update check and enhance local server handling in test script
- Add window channel and utility functions for enhanced window management
- add companion overlay setting actions and break appearance sections
- update dependencies and remove unused tests
- add avatar customizer preview and top bar components
- add bundled landscape photos and slideshow functionality for Gallery Focus
- enhance break overlay settings and user experience
- Update BreakTemplateErrorView to use new color palette and improve text styles
- enhance Sparkle updater integration with improved update handling and checks
🐛 Bug Fixes
- resend extended break end time to overlay after wake
- pause break countdown while system is asleep or locked
- gallery tile row shrinks, pill label ellipsizes; deterministic goldens via package:clock
- keep overlay dark by default, separate a11y nodes, light-theme legibility
⚡ Improvements
- Rename Bool function to GetBool for clarity and consistency
🔧 Build & Maintenance
- clean up build byproducts before rebase in macOS release workflow
- drop golden failure artifacts and ignore them
- render matrix, behavior, palette and golden tests for all 29 templates
Other Changes
- redesign(wind_down): warm evening canvas, stat tiles and autofocused Done button
- redesign(night_sky): starfield with constellations, meteors and dawn; headline uses the break label
- redesign(paper_light): editorial page with hairline, serif countdown and e-ink flash
- redesign(dusk_glow): violet twilight with real moon phase and aurora curtains; own label copy
- redesign(open_field): procedural landscape fallback, swaying grass, drifting mist, horizon focal point
- redesign(warm_amber): blue-free sunset canvas, breathing horizon glow, amber action
- redesign(haiku_card): paper card with staggered poem lines, sumi-e ridges and grain
- redesign(step_guide): step chain with filling tracks and number-to-check morph
- redesign(split_view): timer pane and guidance carousel with glowing divider
- redesign(day_stack): block stack that builds up with the day, glowing active block
- redesign(time_slice): segmented ring, one slice per 5s, pop on elapse
- redesign(mono_time): phosphor terminal with typed entrance, blinking cursor and CRT layer
- redesign(clock_face): Swiss dial with cached bezel, growing sector and seconds hand
- redesign(hud): reticle canvas, hero countdown, ticked progress bar with pulsing head
- redesign(classic): Gallery Focus with gradient fallback, Ken Burns, collapsible glass card
- redesign(quiet_pill): spring-expanding glass pill with liquid fill and tip bubble
- redesign(iris_rest): eight-blade aperture, compliance dots with labels, streak chart retained
- redesign(soft_arc): open 240-degree gauge with cached ticks, needle dot and tick flash
- redesign(ring_only): hairline ring with tapered head, flash and haptic on completion
- redesign(wave_calm): three filled sine waves with crest particles
- redesign(focus_orb): layered glowing sphere with evening amber tint
- redesign(pulse_dot): staggered ripples, spring hover core, static ring fallback
- redesign(one_word): draining accent word with widening tracking
- redesign(breathe_line): glowing line with reflection, live-region phase text
- redesign(zen): Catmull-Rom breathing blob, live-region phase text, reduced-motion swell
- redesign(minimal): Quiet Grid with ticked comet ring and breathing dot grid
- redesign(floating): 280x72 glass card, micro arc, 6-anchor spring snap, hover tip
- redesign(companion): glass dock, rimmed pet with bob/squash/hop, scrim and vignette
- redesign(activities): glass segmented control with spring capsule, keyboard tabs, palette tokens
- redesign(tokens): break overlay palette, motion tokens, break_kit and gallery preview fixes
Full changelog: v1.9.0...v1.11.0
🍎 Installing on macOS
BreakMate is not notarized by Apple, so a DMG downloaded in a browser may show "Apple could not verify BreakMate…". Use either fix:
Option 1: one-line install (recommended)
curl -fsSL https://github.com/bijithpn/standup/releases/latest/download/install.sh | bashOption 2: you already downloaded the DMG
xattr -cr /Applications/BreakMate.appor open System Settings → Privacy & Security → Open Anyway.
Homebrew
brew tap bijithpn/standup https://github.com/bijithpn/standup
brew install --cask breakmateUninstall: curl -fsSL https://github.com/bijithpn/standup/releases/latest/download/uninstall.sh | bash (add -s -- --purge to also delete settings). Linux: uninstall_linux.sh, Windows: uninstall.ps1.
🐧 Linux / 🪟 Windows one-liners
curl -fsSL https://github.com/bijithpn/standup/releases/latest/download/install_linux.sh | bashirm https://github.com/bijithpn/standup/releases/latest/download/install.ps1 | iexBreakMate v1.9.0
BreakMate v1.9.0
✨ New Features
- update launch behavior to open on current Space and improve user notifications
Full changelog: v1.8.4...v1.9.0
BreakMate v1.8.4
BreakMate v1.8.4
✨ New Features
- add timeout for package info retrieval and log startup events
- enhance pet behavior with new interactions and emotions
- enhance app tracking service with caching and add unit tests
- implement startup splash screen and refactor menu bar mode handling
- update menu bar display options and integrate avatar rendering
⚡ Improvements
- defer tray icon pixel work and add startup timing in profile builds
- overlap startup steps and defer Sparkle updater start
🔧 Build & Maintenance
- update version to 1.8.4+40 in pubspec.yaml
Full changelog: v1.8.2...v1.8.4
BreakMate v1.8.2
BreakMate v1.8.2
✨ New Features
- Enhance avatar customization with species-specific facial features and markings
- add stringKeyedMap utility for handling dynamic IPC data and update related components
- update CI workflows to remove unnecessary dependencies and enhance macOS release caching
- implement release readiness checks and ad-hoc signing for macOS builds
Other Changes
- Add gaze sector tracking and related tests
Full changelog: v1.8.1...v1.8.2
BreakMate v1.8.1
BreakMate v1.8.1
✨ New Features
- enhance GoalsSection with dynamic progress tracking and improved UI components
- clearer timeline, personal insights, and removal of unused UI
- clearer Productivity graphs; honest break options
- bring back Productivity screen, shorten Statistics, explain Activity Segments
- break activity on the Today screen, richer Statistics hero, layout fixes
- single health-reminder switch, one-page Statistics, startup fixes
- implement overlay reset functionality and improve overlay visibility handling
- update README with new walkthrough video and enhance screenshot gallery; remove outdated images
- add release notes generation to macOS release workflow
- update break durations and enhance overlay behavior during breaks
- reduced motion, slider keyboard support, wipe tests, display status label
- Add crash reporting toggle and enhance accessibility for buttons
- Implement single-instance token for IPC and enhance app tracking service
- add Linux support for meeting detection and enhance CI configuration
- scaffold Linux GTK runner and refactor TrayManager to constructor injection
- update dependencies and enhance macOS build configuration
- enhance macOS release workflow and add appcast patching script
- update pre-break warning duration and enhance overlay presentation
- integrate Sentry hygiene configuration and add tests
- update pre-break warning duration and enhance overlay handling for reminders
- Release version 1.8.0 with companion customization and productivity insights
- update tray icon path and enhance overlay handling for break reminders
- improve single-instance port binding and app focus handling on macOS
- add Clock Out dialog and service for end-of-day reflections
- Enhance PiP overlay window functionality and settings
- update PiP window size constraints and add dotted drag handle for improved user interaction
- enhance PipWindowArgs with interaction options and improve window positioning logic
- add companion wandering feature and related settings
- add productivity tracking page and segment inspector
- Implement Blobatar rename dialog handling and associated tests
- Implement 3D avatar shapes and rendering
- Add blobatar_flutter dependency to pubspec.yaml and update pubspec.lock
- Introduce Blobatar companion with dynamic naming and emotional expressions
- Add breed selection to AvatarDefinition and update AvatarCustomizer
- Enhance Avatar Customizer with new features and UI improvements
- Implement 3D Pet Customizer functionality and update button actions
- Remove love/heart particle effects and bounce animation on pet interaction
- Enhance avatar entity handling and implement draggable PiP window functionality
- Enhance PiP background style options and implement context menu for selection
- Update avatar handling and improve PiP window management
- Add Avatar Editor functionality and integrate AvatarWebServer
- Implement 3D gaze tracking in PiP overlay and enhance avatar customizer UI
- Implement singleton pattern for CursorTracker service
- add HabitsSummaryCard widget to display break and focus streaks
- enhance overlay management by implementing DestroyAll method for cleanup
- implement automatic health reminders with randomized timing for posture and eye rest
- enhance quick reminder overlays with full poster support
- add Break Statistics tab with yearly heatmap to Analytics
- add Night Sky break template with starfield-to-dawn transition
- introduce ThemedAppIcon widget and integrate it into various sections
- show full-screen poster reminders outside meetings/presentations
- add PosterReminderOverlay full-screen animated poster widget
- redesign IrisRestTemplate with animated backdrop and streak graph
- add AnimatedNatureBackdrop shared blurred-blob background widget
- add nature accent token and per-point coloring to BreakActivityGraph
- enhance meeting break reminders with presentation detection and update settings for presentation pause
- Enhance analytics features with focus trend and budget tracking
- Add daily budget tracking for app categories
- Add meeting detection service and enhance theme customization
- show App Usage section on the Statistics screen
- add app usage tracking toggle to Privacy section
- add AppUsageTracker and wire it into app lifecycle
- add getAppIcon bridge method and AppIconCache
- add getAppIcon to the app_tracking method channel
- add usageTip category-based insight helper
- add AppUsageService for local per-app usage aggregation
- add appUsageTrackingEnabled setting and storage key
- add new theme presets and improve theme controller functionality
🐛 Bug Fixes
- update GitHub repository references and enhance release notes handling
- Preserve authored colors for base species and breeds in avatar artwork
- add missing shellapi.h include for ExtractIconExW
- register app_tracking bridge and add getAppIcon
⚡ Improvements
- extract shared AppCategorizer from WellnessEngine
🔧 Build & Maintenance
- remove the developer-only Activity Segments page
- fix Linux/Windows builds and add Linux/Windows release workflow
- update sentry_flutter to 9.30.1
- add figma motion json player design spec
- make the AppUsageService pruning test verify actual pruning
- gitignore .superpowers scratch workspace
- update dependencies in pubspec.yaml and pubspec.lock
Other Changes
- Refactor and clean up code across multiple files
- Remove unused components and tests related to NPCs, throwable toys, and particle effects
- Refactor test cases for improved readability and consistency
- Refactor widget tests for improved readability and consistency
- Add tests for calendar sync section and refactor settings tests
- Update macOS deployment target and enhance overlay functionality
- Add comprehensive tests for activity segments and productivity insights
- Refactor dependencies and update package versions
- Refactor pet companion service and renderer architecture
- Refactor Avatar Customizer UI and Enhance Companion Settings
- Add unit tests for AvatarView widget functionality and interactions
- Add comprehensive tests for analytics features and insights
- Enhance settings and wellness library UI with new features and improvements
Full changelog: v1.8.0...v1.8.1
BreakMate v1.8.0
BreakMate 1.8.1 — Reliable Software Updates
This release improves the update check in Settings so you can tell whether BreakMate connected to the update server and whether an update is available.
Improvements
- More reliable manual checks: Check Now starts a fresh Sparkle update probe instead of relying on the scheduled background check.
- Clearer connection feedback: Update check errors are shown in Settings, and a check that receives no response ends with a timeout message instead of spinning indefinitely.
- Quieter update checks: Results appear in BreakMate's Software Update section without opening a separate Sparkle check window.
Build 38
BreakMate v1.7.0
BreakMate 1.7.0 — Customizable Companions, Productivity Insights & PiP Improvements
BreakMate 1.7.0 brings a more personal desktop companion, clearer productivity insights, and a smoother break experience.
What's New
- Build a 3D companion: Customize your companion's shape, species, breed, colors, and expression, then give it a name of your own.
- Track your workday: Explore activity segments and inspect how your time is distributed across focused work.
- Clock out with a reflection: Wrap up the day with a guided end-of-day reflection.
- Let your companion wander: Enable companion movement around the workspace and adjust its behavior.
- See your habits: Companion settings now include a summary of break and focus streaks.
- More ways to take a break: Try animated poster reminders, automatic posture and eye-rest prompts, a yearly break statistics heatmap, and the Night Sky break template.
Improvements
- Improved Picture-in-Picture dragging, sizing, positioning, and background controls.
- Refined companion rendering, gaze tracking, and interactions.
- Improved macOS single-instance startup and application focus handling.
- Improved cleanup for secondary overlay windows.
Build 36 · 17 October 2026
BreakMate v1.6.0
BreakMate 1.6.0
New:
- App Usage Analytics — Local, privacy-first tracking of active foreground apps, giving you clear visibility into where your desktop time goes. View it on the Statistics screen and in Settings → Privacy.
- Category Daily Budgets — Set daily time goals for specific application categories (e.g. Browsing, Social, Entertainment) and track your limits throughout the day.
- Focus Score & Trend Charts — Measure your daily focus score, track multi-day focus trends, and celebrate sustained focus streaks as you build healthier working habits.
- Weekly Digest & Export — Receive an automated weekly breakdown of your productivity habits, break compliance, and top apps with one-click export support.
- 6 New Curated Themes — Expand your visual experience with Crimson Ember, Ocean Abyss, Aurora Borealis, Desert Dusk, Lavender Mist, and Monokai Pro (12 curated themes in total).
- Template Accent Customization — Personalize and pin custom accent colors directly to individual break overlay templates in Settings → Break Appearance.
- Revamped Wellness Library — Browse and filter wellness exercises by category with interactive preview cards and updated daily goals.
- Smarter Meeting Detection — Improved native detection and video conference URL recognition to seamlessly defer scheduled breaks during active meetings.
Improved:
- Updated core dependencies for enhanced performance, smoother animations, and platform stability.
- Native app icon caching on macOS and Windows for fast, crisp icon rendering.
Under the hood:
- Added Windows app tracking native bridge support.
- Strengthened automated test coverage for analytics, timer orchestration, and privacy features.
BreakMate v1.5.0
BreakMate 1.5.0
New:
- Global Hotkey — press ⌘⌥B (Ctrl+Alt+B on Windows) anywhere to start a break instantly, or skip the one you're in. Toggle it in Settings → General.
- Presentation Pause — BreakMate now notices when you're in a fullscreen presentation or video call and holds off on breaks until you're done. Toggle it in Settings → Smart Detection. (macOS only for now — Windows support is on the way.)
- Companion Streaks — your desktop companion now celebrates real milestones (3, 7, 14, 30, 60, 100 days) as you build a consistent break habit. Check your progress in Settings → Companion.
- Smarter Meeting-Aware Scheduling — when a break would land during a meeting, BreakMate now looks ahead across your calendar to find the next real gap, instead of just waiting 5 minutes and trying again.
Improved:
- Smaller install size — break-screen slideshow images were re-optimized (~13 MB → ~2.3 MB) with no visible quality loss.
Under the hood:
- Internal settings-code cleanup and documentation fixes — no visible changes, just a healthier codebase going forward.
BreakMate v1.4.0
BreakMate Release Notes — v1.4.0 (Build 33)
Date: June 16, 2026
Release Title: Desktop Companion Engine & Environment Builder
Summary
This major update introduces a completely overhauled Desktop Companion experience. We've built a custom sprite animation engine, a flexible environment builder, and an interactive Picture-in-Picture (PiP) overlay to ensure your companion stays with you across all your workspaces.
🚀 What's New
🐾 Desktop Companion Engine
A new animation and behavior system that makes your desktop pets feel more alive.
- Sprite Rendering Engine: Optimized for low CPU usage while supporting complex animations.
- Advanced State Machines: Pets now have more fluid transitions between idling, moving, and resting.
- Ground-Padding Detection: Dynamic stabilization ensures pets stay perfectly aligned with their environment.
🌎 Environment Builder
Customize your companion's world exactly how you like it.
- Live Preview: See changes in real-time as you build your environment.
- Theme Configuration: New repository-backed themes for consistent world-building.
- Interactive Decorations: Added background birds and environment-aware props.
🖼️ Interactive PiP Overlay
Keep your companion visible without it getting in the way.
- Cross-Workspace Visibility: High-performance overlay window that floats above other apps.
- Smart Initialization: Updated persistence for PiP settings.
🛠️ Improvements & Refinements
📦 Centralized Storage System
- Migrated to a unified
StorageService. - Built-in data migration logic for seamless updates.
- Multi-process access management for improved stability.
⚙️ Infrastructure & Architecture
- Service Bootstrapping: Modernized startup sequence for faster app launches.
- Dependency Injection: Refined DI configuration using a modular pattern.
- NPC Unification: Consolidated movement and component logic for better performance.
🐞 Bug Fixes
- Painting Errors: Fixed occasional zero-size rendering issues on window resize.
- High-DPI Support: Improved crispness and scaling on 4K Windows displays.
- UI Cleanup: Removed intrusive scrollbars from settings and dashboard pages.
📊 Build Details
- Version: 1.4.0
- Build Number: 33
- Commit Range: v1.3.0...HEAD