# floorp-projects/floorp architecture

> Architecture diagram of the GitHub repository floorp-projects/floorp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/floorp-projects/floorp
- Repository: https://github.com/floorp-projects/floorp

## Overview

Floorp is a Firefox-based desktop browser. A central user-facing workflow represented here is invoking the command palette, searching commands and browser data, then choosing a result; the tree also shows major browser customization and companion-page capabilities. Source excerpts and index references support several internal relationships, but not every feature’s wiring, so unverified links are omitted. The README identifies Firefox as the browser base but does not describe Floorp’s feature-level runtime flows.

Main entry points: [`browser-features/chrome/common/command-palette/controller.ts`](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/controller.ts) (Palette controller), [`browser-features/chrome/common/command-palette/components/CommandPalette.tsx`](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/components/CommandPalette.tsx) (Palette interface), [`browser-features/chrome/common/command-palette/config.ts`](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/config.ts) (Palette configuration), [`browser-features/chrome/common/workspaces/workspacesTabManager.tsx`](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/workspaces/workspacesTabManager.tsx) (Workspace tabs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_palette["Command palette"]
  node_palette_controller["Palette controller<br/>[controller.ts]"]
  node_palette_registry["Command registry"]
  node_palette_config["Palette configuration<br/>[config.ts]"]
  node_bookmark_search["Bookmark search"]
  node_tab_search["Tab search<br/>[tab-provider.ts]"]
  node_history_search["History search"]
  node_palette_view["Palette interface<br/>[CommandPalette.tsx]"]
end

subgraph group_browser_ui["Browser interface"]
  node_sidebar["Panel sidebar<br/>[index.ts]"]
  node_tabbar["Tab bar<br/>[index.ts]"]
  node_designs["Browser designs<br/>[index.ts]"]
  node_keyboard_shortcuts["Keyboard shortcuts<br/>[controller.ts]"]
end

subgraph group_browser_state["Browser organization"]
  node_workspaces["Workspace tabs"]
  node_workspace_storage[("Workspace data<br/>[data.ts]")]
  node_tab_drag["Tab drag and drop"]
  node_pinned_tabs["Pinned-tab handling"]
  node_split_view["Split view"]
end

subgraph group_companion_pages["Companion pages"]
  node_notes_page["Notes page<br/>[App.tsx]"]
  node_notes_store["Notes persistence<br/>[dataManager.ts]"]
  node_settings_page["Settings page<br/>[dataManager.ts]"]
  node_profile_manager["Profile manager"]
  node_welcome_customization["Welcome customization<br/>[dataManager.ts]"]
end

subgraph group_browser_services["Browser services"]
  node_search_engine_actor["Search engine actors"]
  node_web_highlighting["Web highlighting"]
  node_pwa_service["Web app service<br/>[pwaService.ts]"]
end

node_user(("Browser user"))

node_user -.->|"opens"| node_palette_view
node_palette_view -.->|"uses"| node_palette_controller
node_palette_controller -->|"searches"| node_palette_registry
node_palette_controller -->|"reads"| node_palette_config
node_palette_controller -->|"searches"| node_bookmark_search
node_palette_controller -->|"queries"| node_tab_search
node_palette_controller -->|"queries"| node_history_search
node_workspaces -->|"reads"| node_workspace_storage
node_tab_drag -->|"delegates"| node_pinned_tabs
node_notes_page -->|"loads and saves"| node_notes_store
node_settings_page -.->|"configures"| node_palette_config
node_welcome_customization -.->|"requests engine data"| node_search_engine_actor

click node_palette_controller "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/controller.ts"
click node_palette_registry "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/command-registry.ts"
click node_palette_config "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/config.ts"
click node_bookmark_search "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/bookmark-provider.ts"
click node_tab_search "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/tab-provider.ts"
click node_history_search "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/history-provider.ts"
click node_palette_view "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/components/CommandPalette.tsx"
click node_workspaces "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/workspaces/workspacesTabManager.tsx"
click node_workspace_storage "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/workspaces/data/data.ts"
click node_tab_drag "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/tabbar/multirow-tabbar/tab-drag-drop-manager.ts"
click node_pinned_tabs "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/tabbar/multirow-tabbar/pinned-tab-controller.ts"
click node_split_view "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/split-view/split-view-manager.ts"
click node_sidebar "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/panel-sidebar/index.ts"
click node_tabbar "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/tabbar/index.ts"
click node_designs "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/designs/index.ts"
click node_keyboard_shortcuts "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/keyboard-shortcut/controller.ts"
click node_notes_page "https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-notes/src/App.tsx"
click node_notes_store "https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-notes/src/lib/dataManager.ts"
click node_settings_page "https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-settings/src/app/command-palette/dataManager.ts"
click node_profile_manager "https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-profile-manager/src/lib/profileDataManager.ts"
click node_welcome_customization "https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-welcome/src/app/customize/dataManager.ts"
click node_search_engine_actor "https://github.com/floorp-projects/floorp/blob/main/browser-features/modules/actors/NRSearchEngineParent.sys.mts"
click node_web_highlighting "https://github.com/floorp-projects/floorp/blob/main/browser-features/modules/actors/webscraper/HighlightManager.ts"
click node_pwa_service "https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/pwa/pwaService.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_palette_controller,node_palette_registry,node_palette_config,node_bookmark_search,node_tab_search,node_history_search,node_palette_view,node_user toneBlue
class node_sidebar,node_tabbar,node_designs,node_keyboard_shortcuts toneAmber
class node_workspaces,node_workspace_storage,node_tab_drag,node_pinned_tabs,node_split_view toneMint
class node_notes_page,node_notes_store,node_settings_page,node_profile_manager,node_welcome_customization toneRose
class node_search_engine_actor,node_web_highlighting,node_pwa_service toneIndigo
```

## Components

### Command palette

- [Palette controller](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/controller.ts): `browser-features/chrome/common/command-palette/controller.ts`
- [Command registry](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/command-registry.ts): `browser-features/chrome/common/command-palette/command-registry.ts`
- [Palette configuration](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/config.ts): `browser-features/chrome/common/command-palette/config.ts`
- [Bookmark search](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/bookmark-provider.ts): `browser-features/chrome/common/command-palette/bookmark-provider.ts`
- [Tab search](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/tab-provider.ts): `browser-features/chrome/common/command-palette/tab-provider.ts`
- [History search](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/history-provider.ts): `browser-features/chrome/common/command-palette/history-provider.ts`
- [Palette interface](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/command-palette/components/CommandPalette.tsx): `browser-features/chrome/common/command-palette/components/CommandPalette.tsx`

### Browser interface

- [Panel sidebar](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/panel-sidebar/index.ts): `browser-features/chrome/common/panel-sidebar/index.ts`
- [Tab bar](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/tabbar/index.ts): `browser-features/chrome/common/tabbar/index.ts`
- [Browser designs](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/designs/index.ts): `browser-features/chrome/common/designs/index.ts`
- [Keyboard shortcuts](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/keyboard-shortcut/controller.ts): `browser-features/chrome/common/keyboard-shortcut/controller.ts`

### Browser organization

- [Workspace tabs](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/workspaces/workspacesTabManager.tsx): `browser-features/chrome/common/workspaces/workspacesTabManager.tsx`
- [Workspace data](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/workspaces/data/data.ts): `browser-features/chrome/common/workspaces/data/data.ts`
- [Tab drag and drop](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/tabbar/multirow-tabbar/tab-drag-drop-manager.ts): `browser-features/chrome/common/tabbar/multirow-tabbar/tab-drag-drop-manager.ts`
- [Pinned-tab handling](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/tabbar/multirow-tabbar/pinned-tab-controller.ts): `browser-features/chrome/common/tabbar/multirow-tabbar/pinned-tab-controller.ts`
- [Split view](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/split-view/split-view-manager.ts): `browser-features/chrome/common/split-view/split-view-manager.ts`

### Companion pages

- [Notes page](https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-notes/src/App.tsx): `browser-features/pages-notes/src/App.tsx`
- [Notes persistence](https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-notes/src/lib/dataManager.ts): `browser-features/pages-notes/src/lib/dataManager.ts`
- [Settings page](https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-settings/src/app/command-palette/dataManager.ts): `browser-features/pages-settings/src/app/command-palette/dataManager.ts`
- [Profile manager](https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-profile-manager/src/lib/profileDataManager.ts): `browser-features/pages-profile-manager/src/lib/profileDataManager.ts`
- [Welcome customization](https://github.com/floorp-projects/floorp/blob/main/browser-features/pages-welcome/src/app/customize/dataManager.ts): `browser-features/pages-welcome/src/app/customize/dataManager.ts`

### Browser services

- [Search engine actors](https://github.com/floorp-projects/floorp/blob/main/browser-features/modules/actors/NRSearchEngineParent.sys.mts): `browser-features/modules/actors/NRSearchEngineParent.sys.mts`
- [Web highlighting](https://github.com/floorp-projects/floorp/blob/main/browser-features/modules/actors/webscraper/HighlightManager.ts): `browser-features/modules/actors/webscraper/HighlightManager.ts`
- [Web app service](https://github.com/floorp-projects/floorp/blob/main/browser-features/chrome/common/pwa/pwaService.ts): `browser-features/chrome/common/pwa/pwaService.ts`

### Other components

- **Browser user**

## Connections

- Browser user → Palette interface: opens
- Palette interface → Palette controller: uses
- Palette controller → Command registry: searches (evidence: `browser-features/chrome/common/command-palette/controller.ts`)
- Palette controller → Palette configuration: reads (evidence: `browser-features/chrome/common/command-palette/controller.ts`)
- Palette controller → Bookmark search: searches (evidence: `browser-features/chrome/common/command-palette/controller.ts`)
- Palette controller → Tab search: queries (evidence: `browser-features/chrome/common/command-palette/controller.ts`)
- Palette controller → History search: queries (evidence: `browser-features/chrome/common/command-palette/controller.ts`)
- Workspace tabs → Workspace data: reads (evidence: `browser-features/chrome/common/workspaces/workspacesTabManager.tsx`)
- Tab drag and drop → Pinned-tab handling: delegates (evidence: `browser-features/chrome/common/tabbar/multirow-tabbar/tab-drag-drop-manager.ts`)
- Notes page → Notes persistence: loads and saves (evidence: `browser-features/pages-notes/src/App.tsx`)
- Settings page → Palette configuration: configures
- Welcome customization → Search engine actors: requests engine data
