Break the digital spell! A mystical break reminder app for macOS that helps you maintain healthy screen time habits with beautiful, immersive break experiences.

• Mystical Break Experience: Full-screen overlay with flowing aurora waves and ambient particles
• Smart Scheduling: Customizable break intervals (default: every 20 minutes)
• Hold-to-Skip: Press and hold to skip if needed (duration scales with break length)
• Time-Based Themes: Color palettes shift with time of day (dawn, day, evening, night)
• Ambient Soundscape: Optional relaxing sounds during breaks
• Menu Bar Control: Unobtrusive icon with quick access to settings
• Break Statistics: Track your break completion rate

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

1. Download the latest release from spellbreak.app
2. Move Spellbreak.app to your Applications folder
3. Launch it and allow notifications if you want the heads-up alerts

git clone https://github.com/pabloalvarado/spellbreak.git
cd spellbreak
./build-app.sh
open build/Spellbreak.app

• Menu Bar: Click the Spellbreak icon to access controls
• Preferences: Customize break intervals, duration, heads-up timing, sounds, and visuals
• Skip Break: Hold the skip button for 1 second per minute of break time
• Pause/Resume: Temporarily pause break reminders when needed

Spellbreak respects your privacy:

• ✅ No data collection or analytics
• ✅ All settings stored locally
• ✅ No network connections
• ✅ Fully sandboxed
• ✅ No microphone access

Built with:

• Swift 5.9+
• SwiftUI
• Swift Package Manager

Sources/Spellbreak/
├── SpellbreakApp.swift     # Main app entry point
├── OverlayWindow.swift     # Break overlay interface
├── AuroraBackground.swift  # Animated wave effects
├── PreferencesView.swift   # Settings interface
├── MenuViewSimple.swift    # Menu bar UI
└── SoundManager.swift      # Audio handling

For website / direct distribution:

./build-dmg.sh --sign "Developer ID Application: Your Name (TEAMID)"

For Mac App Store submission, archive the app in Xcode and upload that archive to App Store Connect with the proper App Store distribution workflow.

Copyright © 2025 Pablo Alvarado. All rights reserved.

For issues or feature requests, visit github.com/pabloalvarado/spellbreak