Desktop App Overview

​

Supported Platforms

• Windows: x64, ARM64, and ia32 architectures
  • Microsoft Store version
  • Portable version
  • Standard installer
• macOS: Universal binaries (Intel + Apple Silicon)
  • Mac App Store (MAS) version
  • Direct download DMG
• Linux: x64 and ARM64
  • AppImage
  • Snap package
  • Flatpak
  • tar.gz archive

​

Technology Stack

​

Frontend

• Framework: Angular
• Runtime: Electron renderer process (Chromium-based)
• UI: Component Library shared across Bitwarden clients
• Styling: Tailwind CSS

​

Backend (Main Process)

• Runtime: Electron main process (Node.js)
• Native Modules: Rust via N-API
• IPC: Electron’s Inter-Process Communication

​

Native Integration

• Biometric authentication: Windows Hello, Touch ID, Linux polkit
• SSH Agent: Secure SSH key management
• Autofill: Platform-native autofill providers
• Clipboard: Secure clipboard operations
• Password storage: OS keychain integration
• Process isolation: Security sandboxing
• Chromium import: Browser password import utilities

​

Project Structure

apps/desktop/
├── src/
│   ├── main.ts              # Main process entry point
│   ├── preload.ts           # Preload script
│   ├── app/                 # Angular application (renderer)
│   ├── main/                # Main process modules
│   ├── platform/            # Platform services
│   ├── auth/                # Authentication
│   ├── autofill/            # Autofill functionality
│   └── key-management/      # Biometrics & key management
├── desktop_native/          # Rust native modules
│   ├── core/                # Core Rust functionality
│   ├── napi/                # N-API bindings
│   ├── autofill_provider/   # Platform autofill
│   ├── ssh_agent/           # SSH agent
│   └── ...
├── resources/               # App resources & icons
└── package.json

​

Key Features

​

Native Integration

• Biometric Unlock: Platform-native biometric authentication
• Auto-start: Launch on system startup
• System Tray: Background operation with tray icon
• Native Notifications: OS-level notifications
• Dark Mode: System theme integration

​

Browser Integration

• Native Messaging: Communication with browser extensions
• Password Import: Import from Chrome, Edge, and other Chromium browsers
• DuckDuckGo Integration: Specialized manifest generation

​

Security Features

• Process Isolation: Sandboxed processes for enhanced security
• Secure Memory: Memory encryption for sensitive data
• SSH Agent: Secure SSH key storage and usage
• Clipboard Protection: Secure clipboard with auto-clear

​

Version Information

​

Platform Detection

// Device type detection
switch (process.platform) {
  case "win32":
    return DeviceType.WindowsDesktop;
  case "darwin":
    return DeviceType.MacOsDesktop;
  default:
    return DeviceType.LinuxDesktop;
}

• Windows: Windows Hello, DPAPI for secure storage, Registry access
• macOS: Touch ID, Keychain integration, Safari autofill extension
• Linux: Polkit authentication, Secret Service API, X11/Wayland support

​

Distribution Variants

• Standard: Regular installer/package
• Portable: Windows portable executable
• Store: Microsoft Store and Mac App Store versions
• Beta: Beta channel builds with separate configuration

​

Related Documentation

• Building the Desktop App
• Architecture Details
• Native Modules