Coding in Peace - The Story Behind Harmonia Zen
Source: Dev.to
The Distraction Problem
Every developer knows the feeling. You’re deep in a complex problem, the logic is finally clicking into place, and then… a notification. A sidebar catches your eye. The minimap reminds you of that other bug you meant to fix. Your flow is broken.
VS Code’s built‑in Zen Mode was supposed to solve this. Toggle it on, and the UI disappears. But I found myself frustrated by its all‑or‑nothing approach. Sometimes I need line numbers. Sometimes I want the minimap but not the sidebar. The binary choice felt limiting.
The Control I Wanted
I started keeping notes on my ideal setup for different tasks:
- Deep debugging – Keep line numbers and gutter, hide everything else
- Writing documentation – Minimal interface, but keep the scrollbar for navigation
- Quick edits – Almost everything visible for context
- Long coding sessions – Just the essentials, plus something to structure my time
That last point led me to the Pomodoro Technique. I’d been using it for years with external timers, but context‑switching to another app always felt like a small interruption in itself.
What if my editor could handle both? A truly customizable Zen Mode, plus a built‑in timer that understands the rhythm of focused work?
Building Harmonia Zen
The core idea was simple: give developers granular control over their environment.
Instead of one Zen Mode toggle, Harmonia Zen offers 17 individual controls:
- Editor elements – line numbers, gutter, minimap, breadcrumbs, indent guides, bracket pairs, rulers
- Scrollbars – vertical and horizontal separately
- Workbench – activity bar, status bar, sidebar, panel, tabs
- Behavior – cursor blinking, whitespace rendering, line highlighting
Each one can be toggled independently. Your preferences are remembered. When you exit Zen Mode, your original settings return exactly as they were.
Preset Profiles
Remembering 17 toggles for different scenarios can become its own cognitive load, so I built presets:
| Preset | Philosophy |
|---|---|
| Minimal | Everything hidden. Pure text and thought. |
| Writer | Clean but navigable. Good for prose and documentation. |
| Focus | Keep the coding aids (line numbers, indent guides), hide the distractions. |
| Custom | Save your own configuration and recall it instantly. |
Switch between them with a single click—no friction.
The Pomodoro Integration
The Pomodoro Technique structures work into focused intervals (traditionally 25 minutes), followed by short breaks (5 minutes), with longer breaks after several sessions. It prevents burnout and keeps you aware of time passing.
I built the timer directly into the extension:
- Visual indicator in the status bar showing time remaining
- Session tracking so you know which interval you’re on
- Customizable durations because 25 minutes isn’t right for everyone
- Auto‑start option for continuous flow without manual intervention
The timer respects your focus. No intrusive pop‑ups—just a status‑bar update when your session ends.
Focus Statistics
After using the timer for a while, I wanted to understand my patterns. Harmonia Zen tracks:
- Daily sessions and focus time
- Current streak and longest streak
- Weekly overview with visual charts
- All‑time cumulative statistics
All data is stored locally. No cloud sync, no analytics, no telemetry. Your productivity data stays yours.
What I Hope You Get From It
If you’ve ever wished Zen Mode was more flexible, or if you’ve bounced between different Pomodoro apps looking for one that integrates with your workflow, Harmonia Zen might help.
It’s not about forcing a specific productivity system on you. It’s about giving you the controls to create the environment that works for your brain. Whether you prefer minimal interfaces, more context, strict time boundaries, or uninterrupted flow, Harmonia Zen tries to accommodate all of these.
Privacy by Design
Like all Harmonia extensions, privacy is non‑negotiable:
- No telemetry or analytics
- No external communication
- All settings and statistics stored locally in VS Code
- Open source under the MIT license
Your focus is yours. Your data is yours.
Where to Find It
Harmonia Zen is available now on the Visual Studio Code Marketplace:
Thanks for Reading
We spend countless hours in our code editors. Making that environment comfortable, focused, and personalized feels like time well invested.
If you try Harmonia Zen, I’d love to hear how it fits into your workflow. What presets work for you? What Pomodoro durations feel right? Feedback helps shape future improvements.
Code in peace.