Your Eyes Deserve a Break
A desktop application designed to reduce eye strain and promote healthy screen habits through intelligent break reminders and display optimization.
BlinkBreak is a cross-platform desktop application built with Electron that helps prevent digital eye strain by implementing the 20-20-20 rule and providing customizable break intervals. The application runs in the background and reminds users to take regular breaks, adjust their display settings, and maintain healthy computing habits.
- ✓ Smart Break Timer - Customizable intervals and break lengths with a polished experience
- ✓ Hard Mode - Full-screen focus lock for deep work sessions
- ✓ Soft Mode - Gentle popup reminders that respect your flow
- ✓ Smart Mode - Auto-detects active sessions and pauses breaks when needed
- ✓ Multi-Monitor Support - Covers all displays with adaptive behavior
- ✓ System Tray - Runs quietly in the background with live status
- ✓ Auto-Launch - Starts with Windows from Settings
- ✓ Settings Persistence - Your preferences stay intact across restarts
- ✓ Statistics Tracking - Review screen time, streaks, and daily progress
- ✓ Health Reminders - Posture and hydration prompts with custom sounds
- ✓ Monitor Controls - Adjust brightness, contrast, and display presets
- ✓ Blue Light Filter - Warm-screen comfort for longer work sessions
- ✓ Color Mask - Apply soft color overlays to reduce visual fatigue
- ✓ Focus Mode - Block distracting websites system-wide
- ✓ Dual Themes - Modern dark and light experiences
- ✓ Single Instance - Prevents duplicate app windows
- ○ Global keyboard shortcuts
Latest Release: v1.2.0
Installer (Recommended): BlinkBreak Setup 1.2.0.exe
- Installs to Program Files with shortcuts
Portable: BlinkBreak 1.2.0.exe
- No installation required
Requirements: Windows 10/11 (64-bit)
- Download and install BlinkBreak
- App starts with default: 20 min interval, 20 sec break
- Customize timer in Timer tab
- App runs in system tray - click to show/hide
- Enable/disable auto-launch in Settings
# Clone repository
git clone https://github.com/rahad-hossain/BlinkBreak.git
cd BlinkBreak
# Install dependencies
npm install
# Run in development
npm run dev
# Build for production
npm run build
npm run build:electron- Electron 28 - Desktop framework
- React 18 - UI library
- TypeScript - Type safety
- TailwindCSS - Styling
- Zustand - State management
- electron-store - Data persistence
BlinkBreak/
├── src/
│ ├── main/ # Electron main process
│ ├── renderer/ # React application
│ ├── preload/ # Preload script for IPC
│ └── shared/ # Shared types and utilities
├── public/ # Static assets
└── dist/ # Build output
npm run dev # Start development server
npm run build # Build all processes
npm run build:electron # Package for distribution
npm run lint # Run ESLintBlinkBreak is designed with eye health as the primary focus. The color scheme uses warm tones to reduce blue light exposure, maintains high contrast without harsh whites, and implements reduced saturation to prevent eye fatigue. The interface is minimal and intuitive, with smooth animations that respect user accessibility preferences. All user data is stored locally with no telemetry or external server communication.