Zen Browser is a privacy-focused, open-source web browser built on Firefox 149.0, engineered to help users stay productive by reducing digital clutter and streamlining workflow. It targets professionals, students, and content creators who need a clean, distraction-free browsing experience without sacrificing functionality.
Built on the Firefox engine with WebExtensions support, Zen integrates native features like Workspaces, Split View, and Compact Mode while maintaining compatibility with Firefox add-ons. It supports cross-platform deployment (Windows, macOS, Linux) and is distributed via GitHub Releases with CI/CD pipelines for stable and twilight (RC) builds.
What You Get
- Workspaces - Organize tabs into named, isolated groups to separate projects, reducing tab overload and improving focus.
- Compact Mode - Dynamically hides the tab bar when inactive to maximize screen real estate, revealing it only on hover or keyboard input.
- Glance - Quickly switch between frequently used tabs without scrolling through history or opening new windows.
- Split View - View two tabs side by side for easy comparison, research, or multitasking without tab switching.
- Firefox 149.0 Base - Built on the latest stable Firefox engine, ensuring full compatibility with extensions, DevTools, and web standards.
- Open Source & Privacy-First - Fully open-source (MPL 2.0), with no telemetry or data collection, prioritizing user privacy by default.
Common Use Cases
- Managing multiple research projects - A student uses Workspaces to isolate tabs for literature review, citation tools, and note-taking apps without tab chaos.
- Comparing product specs or designs - A product manager uses Split View to view two competitor websites side-by-side while taking notes.
- Minimizing distractions during deep work - A developer enables Compact Mode to hide the tab bar and reduce visual noise while coding or writing.
- Rapidly switching between daily tools - A content creator uses Glance to jump between their email, CMS dashboard, and social media analytics without reopening tabs.
Under The Hood
Architecture
- Deep integration with Firefox’s core components including CustomizableUI, UrlbarUtils, and nsStyleSheetService, enabling Zen-specific behaviors through direct patches rather than extensions
- Modular communication via JSWindowActorChild/Parent patterns for secure, isolated mod management and cross-process messaging
- Centralized global state management through monolithic gZen* variables that tightly couple UI logic with browser internals
- Custom build toolchain using Surfer to patch, sync, and package upstream Firefox source, resulting in a fork-based architecture with extensive modifications
- Theme and UI customization achieved through dynamic CSS/JS injection without formal dependency injection or component boundaries
- High coupling between UI logic and Firefox’s C++-backed systems, increasing maintenance complexity and reducing isolation
Tech Stack
- Electron-based desktop application built on Firefox’s Gecko engine with custom branding and update infrastructure
- TypeScript frontend with Babel and CommonJS module system targeting modern ECMAScript standards
- Custom build and packaging system powered by Surfer for Firefox source integration, localization, and binary generation
- Mozilla’s Fluent (FTL) localization system used consistently across browser components
- CI/CD and development workflows managed via Python scripts for source synchronization and pre-commit hooks with husky and lint-staged
- MPL-2.0 licensed with custom configurations for branding and release variants
Code Quality
- Extensive test suite leveraging Mozilla’s mochitest and browser chrome frameworks to validate UI interactions, preferences, and low-level system behaviors
- Strong type safety and modular structure through ES modules and well-organized system JS components
- Robust error handling with asynchronous assertions and platform-specific fallbacks, though lacking custom error classes
- Consistent naming conventions aligned with Mozilla’s standards, enhancing readability and maintainability
- Comprehensive linting and formatting practices with targeted suppressions for legacy or platform-specific code
- Tests deeply integrated with browser internals using specialized utilities, avoiding mocks and ensuring real-world behavior validation
What Makes It Unique
- Native workspace-based tab organization deeply integrated with bookmark management, enabling persistent, context-aware tab groupings
- Context-aware URL bar that activates commands mode when empty, transforming navigation into a keyboard-driven workflow
- Glance feature triggered by system-level shortcuts to surface contextual information without disrupting user flow
- Native macOS popover implementation with precise UI consistency patches while extending functionality
- Unprecedented Windows API bindings for default browser control, alert systems, and module blocklisting
- Modular patch management system that layers customizations atop Firefox while preserving upstream compatibility