# corbindavenport/just-the-browser architecture

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

- Interactive diagram: https://gitdiagram.com/corbindavenport/just-the-browser
- Repository: https://github.com/corbindavenport/just-the-browser

## Overview

Just the Browser distributes managed browser settings that reduce unwanted features and reporting. Users can run an installer or follow a browser-specific manual guide; the result is a browser-specific configuration in registry, profile, or policy-file form. The README documents the installer and four browser guides/configuration sets. Script internals and the specific files each script installs were not sampled, so the diagram shows only documented relationships.

Main entry points: [`main.ps1`](https://github.com/corbindavenport/just-the-browser/blob/main/main.ps1) (Windows installer), [`main.sh`](https://github.com/corbindavenport/just-the-browser/blob/main/main.sh) (Mac/Linux installer), [`chrome/managed_policies.json`](https://github.com/corbindavenport/just-the-browser/blob/main/chrome/managed_policies.json) (Chrome settings), [`firefox/policies.json`](https://github.com/corbindavenport/just-the-browser/blob/main/firefox/policies.json) (Firefox settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation"]
  node_windows_script["Windows installer<br/>[main.ps1]"]
  node_unix_script["Mac/Linux installer<br/>[main.sh]"]
end

subgraph group_guides["Browser Guides"]
  node_chrome_guide["Chrome guide<br/>[README.md]"]
  node_edge_guide["Edge guide<br/>[README.md]"]
  node_firefox_guide["Firefox guide<br/>[README.md]"]
  node_brave_guide["Brave guide<br/>[README.md]"]
end

subgraph group_configs["Browser Configurations"]
  node_chrome_config["Chrome settings"]
  node_edge_config["Edge settings"]
  node_firefox_config["Firefox settings<br/>[policies.json]"]
  node_brave_config["Brave settings"]
end

node_user(("Browser user"))

node_user -->|"runs on Windows"| node_windows_script
node_user -->|"runs on Mac/Linux"| node_unix_script
node_windows_script -->|"installs settings"| node_chrome_config
node_windows_script -->|"installs settings"| node_edge_config
node_windows_script -->|"installs settings"| node_firefox_config
node_windows_script -->|"installs settings"| node_brave_config
node_unix_script -->|"installs settings"| node_chrome_config
node_unix_script -->|"installs settings"| node_edge_config
node_unix_script -->|"installs settings"| node_firefox_config
node_unix_script -->|"installs settings"| node_brave_config
node_user -->|"follows guide"| node_chrome_guide
node_user -->|"follows guide"| node_edge_guide
node_user -->|"follows guide"| node_firefox_guide
node_user -->|"follows guide"| node_brave_guide
node_chrome_guide -->|"guides installation"| node_chrome_config
node_edge_guide -->|"guides installation"| node_edge_config
node_firefox_guide -->|"guides installation"| node_firefox_config
node_brave_guide -->|"guides installation"| node_brave_config

click node_windows_script "https://github.com/corbindavenport/just-the-browser/blob/main/main.ps1"
click node_unix_script "https://github.com/corbindavenport/just-the-browser/blob/main/main.sh"
click node_chrome_guide "https://github.com/corbindavenport/just-the-browser/blob/main/chrome/README.md"
click node_edge_guide "https://github.com/corbindavenport/just-the-browser/blob/main/edge/README.md"
click node_firefox_guide "https://github.com/corbindavenport/just-the-browser/blob/main/firefox/README.md"
click node_brave_guide "https://github.com/corbindavenport/just-the-browser/blob/main/brave/README.md"
click node_chrome_config "https://github.com/corbindavenport/just-the-browser/blob/main/chrome/managed_policies.json"
click node_firefox_config "https://github.com/corbindavenport/just-the-browser/blob/main/firefox/policies.json"
click node_brave_config "https://github.com/corbindavenport/just-the-browser/blob/main/brave/managed_policies.json"

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_windows_script,node_unix_script,node_user toneBlue
class node_chrome_guide,node_edge_guide,node_firefox_guide,node_brave_guide toneAmber
class node_chrome_config,node_edge_config,node_firefox_config,node_brave_config toneMint
```

## Components

### Installation

- [Windows installer](https://github.com/corbindavenport/just-the-browser/blob/main/main.ps1): `main.ps1`
- [Mac/Linux installer](https://github.com/corbindavenport/just-the-browser/blob/main/main.sh): `main.sh`

### Browser Guides

- [Chrome guide](https://github.com/corbindavenport/just-the-browser/blob/main/chrome/README.md): `chrome/README.md`
- [Edge guide](https://github.com/corbindavenport/just-the-browser/blob/main/edge/README.md): `edge/README.md`
- [Firefox guide](https://github.com/corbindavenport/just-the-browser/blob/main/firefox/README.md): `firefox/README.md`
- [Brave guide](https://github.com/corbindavenport/just-the-browser/blob/main/brave/README.md): `brave/README.md`

### Browser Configurations

- [Chrome settings](https://github.com/corbindavenport/just-the-browser/blob/main/chrome/managed_policies.json): `chrome/managed_policies.json`
- **Edge settings**
- [Firefox settings](https://github.com/corbindavenport/just-the-browser/blob/main/firefox/policies.json): `firefox/policies.json`
- [Brave settings](https://github.com/corbindavenport/just-the-browser/blob/main/brave/managed_policies.json): `brave/managed_policies.json`

### Other components

- **Browser user**

## Connections

- Browser user → Windows installer: runs on Windows (evidence: `README.md`)
- Browser user → Mac/Linux installer: runs on Mac/Linux (evidence: `README.md`)
- Windows installer → Chrome settings: installs settings (evidence: `README.md`)
- Windows installer → Edge settings: installs settings (evidence: `README.md`)
- Windows installer → Firefox settings: installs settings (evidence: `README.md`)
- Windows installer → Brave settings: installs settings (evidence: `README.md`)
- Mac/Linux installer → Chrome settings: installs settings (evidence: `README.md`)
- Mac/Linux installer → Edge settings: installs settings (evidence: `README.md`)
- Mac/Linux installer → Firefox settings: installs settings (evidence: `README.md`)
- Mac/Linux installer → Brave settings: installs settings (evidence: `README.md`)
- Browser user → Chrome guide: follows guide (evidence: `README.md`)
- Browser user → Edge guide: follows guide (evidence: `README.md`)
- Browser user → Firefox guide: follows guide (evidence: `README.md`)
- Browser user → Brave guide: follows guide (evidence: `README.md`)
- Chrome guide → Chrome settings: guides installation (evidence: `README.md`)
- Edge guide → Edge settings: guides installation (evidence: `README.md`)
- Firefox guide → Firefox settings: guides installation (evidence: `README.md`)
- Brave guide → Brave settings: guides installation (evidence: `README.md`)
