What is Zen Mode?
Zen Mode is a fullscreen overlay that:- 🎯 Removes visual distractions - Clean, minimal interface
- 🎵 Plays ambient sounds - Wind, rain, or café noise
- ⏱️ Integrates Pomodoro timer - Track focus sessions
- 🌙 Creates calm atmosphere - Gradient backgrounds and subtle animations
Activating Zen Mode
Start a Pomodoro Session
Begin a focus session from your dashboard or routine timeline.The Pomodoro timer starts counting down based on your focus strategy:
- Pomodoro: 25 minutes
- 50-10: 50 minutes
- 90-15: 90 minutes
Click the Zen Mode Toggle
Look for the Zen Mode button in the Pomodoro timer controls.Click it to enter fullscreen focus mode.
The Zen Mode Interface
Visual Design
The Zen Mode overlay features:- Dark Background - 95% opacity black base
- Gradient Overlay - Subtle primary color gradients
- Glow Effect - Soft radial blur in center
- Minimalist Typography - Large, easy-to-read timer
The interface is designed following minimalist principles to keep your attention on the timer and your work, not the UI.
Giant Timer Display
The centerpiece is a massive countdown timer:- Format: MM:SS
- Size: 8rem (mobile) to 12rem (desktop)
- Style: Gradient text with drop shadow
- Updates: Real-time every second
Session Type Indicator
Below the timer, you’ll see:- FOCUS SESSION - During work periods
- SHORT BREAK - During 5-10 minute breaks
- LONG BREAK - During extended breaks
Auto-Hiding Controls
Controls appear on mouse movement and hide after 6 seconds:- Top Right Corner: Sound controls and exit button
- Bottom Center: Timer playback controls (play/pause/reset)
- Bottom Text: Motivational quote
Why do controls auto-hide?
Why do controls auto-hide?
Research shows that visible UI elements compete for attention during focus work. Auto-hiding controls after 6 seconds creates a truly distraction-free environment while keeping controls accessible when needed.
Ambient Sound Engine
Zen Mode includes a custom-built Web Audio API sound engine that generates soothing ambient noise.Available Sounds
🌬️ Wind (White Noise)
🌬️ Wind (White Noise)
Type: Filtered white noiseCharacteristics:
- Simulates gentle wind/breeze
- Low-pass filtered (600Hz cutoff)
- Subtle LFO modulation for natural variation
- Smooth fade-in/out (2 seconds)
🌧️ Rain (Pink Noise)
🌧️ Rain (Pink Noise)
Type: Procedural pink noiseCharacteristics:
- Mimics steady rainfall
- Medium frequency response (1200Hz cutoff)
- Stereo spread for immersion
- Filtered through 7-pole IIR filter
☕ Café (Brown Noise)
☕ Café (Brown Noise)
Type: Warm brown noiseCharacteristics:
- Simulates café ambiance murmur
- Heavy low-pass filtering (500Hz cutoff)
- Deep, warm bass frequencies
- Smooth, consistent texture
Sound Controls
When controls are visible (top right):- Sound Buttons - Click to switch sound types
- Volume Toggle - Mute/unmute (preserves last volume)
- Active Highlight - Selected sound shows primary color
Volume Management
The sound engine features:- Default Volume: 30% (0.3)
- Range: 0% to 100%
- Fade-in: 2-second gradual increase on play
- Fade-out: 1-second gradual decrease on stop
- Memory: Last volume setting is preserved
Timer Controls
While in Zen Mode, you have full Pomodoro timer control:Playback Controls
- Play - Start countdown
- Pause - Freeze timer
- Reset - Return to session duration
These controls are the same as the standard Pomodoro timer - they’re just styled for Zen Mode.
Session Transitions
The timer automatically transitions between sessions:- Focus Session Ends → Short Break begins
- Short Break Ends → Next Focus Session
- 4th Focus Session Ends → Long Break begins
- Long Break Ends → Cycle restarts
What happens at session transitions?
What happens at session transitions?
When a session completes:
- Timer resets to next session duration
- Session type label updates
- Ambient sound continues uninterrupted
- No browser notification (to avoid disruption)
Exiting Zen Mode
To leave Zen Mode:Click the minimize button
Look for the minimize icon (⬇️) in the top-right corner.Click it to exit fullscreen.
Exiting Zen Mode does NOT stop your timer or sound. They continue playing in the background.
Technical Details
Sound Engine Implementation
TheSoundEngine class uses Web Audio API:
- 4-second looping buffers
- Stereo (2 channels)
- Sample rate: System default (usually 44.1kHz or 48kHz)
- Procedural generation (not recorded files)
- Zero network requests
- Infinite playback without repetition artifacts
- Tiny memory footprint
- Cross-platform compatibility
Browser Compatibility
Zen Mode works in all modern browsers:- ✅ Chrome/Edge 90+
- ✅ Firefox 88+
- ✅ Safari 14+ (including iOS)
- ✅ Opera 76+
Best Practices
When to use Zen Mode
When to use Zen Mode
Ideal situations:
- Timed Pomodoro sessions
- High-difficulty subject study
- Noisy environments (use wind/rain to mask)
- Exam preparation
- Deep work requiring full concentration
- Collaborative work
- Video lectures (audio conflict)
- Quick tasks under 10 minutes
Optimizing your focus environment
Optimizing your focus environment
- Close unnecessary tabs - Zen Mode can’t block notifications
- Silence your phone - Physical distractions still matter
- Use comfortable headphones - Better than speakers for ambient sound
- Adjust screen brightness - Reduce eye strain in dark mode
- Position monitor properly - Ergonomics affect focus
Sound selection strategy
Sound selection strategy
- Wind - Best for blocking variable external noise (traffic, voices)
- Rain - Best for creating calm, relaxed focus state
- Café - Best for reducing silence anxiety, mimics public study
Combining with routine blocks
Combining with routine blocks
When your routine generates a study block:
- Start the Pomodoro timer
- Immediately enter Zen Mode
- Work through the focus/break cycle
- Exit Zen Mode when block completes
- Mark routine block as complete
Keyboard Shortcuts
Currently, Zen Mode does not support keyboard shortcuts. Use mouse/trackpad to interact with controls.
Troubleshooting
No sound playing
No sound playing
Possible causes:
- Browser autoplay policy blocking audio
- System volume muted
- Volume toggle set to mute
- Click the volume button to unmute
- Check system audio settings
- Try clicking elsewhere on the page first (user interaction required)
Controls won't show
Controls won't show
Cause: Mouse movement not detectedSolution:
- Try clicking anywhere on screen
- Move mouse more vigorously
- Check if in true fullscreen (F11)
Timer not syncing with routine
Timer not syncing with routine
Cause: Timer and routine are separate systemsSolution:
- Manually start timer when beginning a routine block
- Mark routine block complete when timer finishes
- They’re designed to work together but aren’t auto-linked
Next Steps
Creating Routines
Learn how routines integrate with focus sessions
Achievements
Earn XP for completing focus sessions