Overview & Philosophy
Mise Browser is a personal, keyboard-centric web browser designed specifically for low-power and fanless Linux systems.
The name Mise originates from the Czech word for "mission" (pronounced roughly as mee-seh). It represents the project's core mission: reclaiming the web browser as an intentional, ultra-lean tool built for privacy, focus, and low-resource efficiency rather than an all-consuming operating system of its own.
Typical desktop browsers consume gigabytes of memory across dozens of background processes, producing heat and throttling on fanless hardware. Mise provides an ultra-lean browsing environment by stripping away unnecessary browser overhead while delivering modern privacy isolation, multi-account containers, and complete mouse-free operation.
Design Principles
- Keyboard First: Every single feature, tab switch, link click, and setting can be reached without touching a mouse.
- Resource Respect: Idle tabs hibernate and detach completely from memory, keeping fanless systems cool and responsive.
- Strict Privacy Isolation: Workspaces operate in isolated container partitions. Work and personal profiles never leak cookies or storage.
- Crash & Session Resilience: Atomic disk writes, rolling backup journals, and clean-exit sentinels protect active workspaces against power cuts or sudden terminations.
- Air-Gapped Security: Untrusted scripts and shell commands are never blindly executed; they pass through clipboard verification.
- Distro & Shell Agnostic: Fully integrated with Arch Linux and native terminal emulators while functioning seamlessly across all environments.
Architecture at a Glance
Mise combines the rendering capabilities of Chromium with Electron and native system utilities across clean, decoupled architectural layers:
- Main Process (
main.js&main/): Efficient lifecycle coordinator (<520 lines) delegating to specialised subsystems: window lifecycle management (main/windowManager.js), web contents security and context menus (main/webContentsPolicy.js,main/contextMenus.js), system IPC handlers (main/systemIpc.js), multi-profile session partitioning (main/sessionStore.js), atomic storage and history journals (main/storage.js), configuration (main/config.js), download shelf monitoring (main/downloads.js), secure permissions (main/permissions.js), GitHub update checks (main/updater.js), and encrypted DNS-over-HTTPS resolution (main/dohResolver.js). - Interface Shell & Modular Templates (
index.html&templates/): Minimal, lean persistent application shell (176 lines) containing only core structural scaffolding (Sidebar, TabList, StatusBar, webview container, and download shelf). All 10 overlay dialogs (Command Palette, Preferences, Workspace Dashboard, Bookmarks, History, Notes, Diagnostics, Peek Modal, Share Modal, and Find Bar) are cleanly extracted into HTML template fragments undertemplates/*and mounted dynamically on demand bymodules/templateLoader.jswith background idle preloading. - Renderer Process (
renderer.js&modules/renderer/): Entry orchestrator (<250 lines) coordinating keyboard shortcuts and domain controllers for session hydration (browserInit.js), sidebar focus trapping and navigation (sidebarController.js), workspace isolation (workspaceController.js), themes (themeController.js), and in-page find (pageSearch.js). - Webview Subsystem (
modules/webview.js&modules/webview/): Orchestrates individual web pages inside sandboxed<webview>tags assigned to specific workspace container partitions. Organised into modular controllers for guest lifecycles (tabLifecycle.js), memory-saving tab hibernation (sleepManager.js), dual-split layouts (splitView.js), and audio controls (audioManager.js). - Style Sheet Subsystem (
style.css&styles/): Vanilla CSS modularised into domain-specific sheets (styles/base.css,styles/layout.css,styles/sidebar.css,styles/statusbar.css,styles/components.css,styles/overlays.css, andstyles/overlays/*) aggregated cleanly via native imports without build tool overhead. - Local Configuration (
~/.config/mise-browser/): Human-readable JSON files and Markdown notes stored safely in your home directory.
First Steps
Once launched, Mise presents a clean, distraction-free window:

- Press Ctrl + L or o to focus the status bar address bar and navigate to any site.
- Press Ctrl + T to open a new tab.
- Press Ctrl + F to activate the Link Hints overlay and navigate links using your keyboard.
- Press Ctrl + P to bring up the Command Palette for quick access to all browser functions.
- Press F1 or Ctrl + H to view Preferences and customise settings.
