# bdelectrickbill21/nirobo-browser architecture

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

- Interactive diagram: https://gitdiagram.com/bdelectrickbill21/nirobo-browser
- Repository: https://github.com/bdelectrickbill21/nirobo-browser

## Overview

Nirobo Browser is an Android WebView browser. The main workflow is user input in the browser UI, URL resolution and tab navigation, then page display with browser controls. The sampled code also shows private browsing, tracker blocking, downloads, fullscreen and file selection, and page-sharing/menu actions. Most behavior lives in one Kotlin file, so the nodes separate its responsibilities rather than implying separate modules. The README is empty, and excerpts omit many implementations; edges are limited to relationships visible in the supplied excerpts.

Main entry points: [`MainActivity.kt`](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt) (WebView pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Browser interaction"]
  node_ui["Browser UI<br/>[MainActivity.kt]"]
  node_menu["Browser menu<br/>[MainActivity.kt]"]
end

subgraph group_browsing["Page browsing"]
  node_tabs["Tab management<br/>[MainActivity.kt]"]
  node_navigation["Address navigation<br/>[MainActivity.kt]"]
  node_webview["WebView pages<br/>[MainActivity.kt]"]
end

subgraph group_protections["Privacy and protection"]
  node_private["Private browsing<br/>[MainActivity.kt]"]
  node_blocklist["Tracker blocking<br/>[MainActivity.kt]"]
  node_blocklistfile["Blocklist data<br/>[blocklist.txt]"]
end

subgraph group_device["Device features"]
  node_downloads["Downloads<br/>[MainActivity.kt]"]
  node_fullscreen["Fullscreen media<br/>[MainActivity.kt]"]
  node_sharing["Page sharing<br/>[MainActivity.kt]"]
end

node_user(("Browser user"))
node_web(("Websites"))
node_devicefiles["Device file picker"]
node_externalapps["Other apps"]

node_user -->|"uses"| node_ui
node_ui -->|"opens tabs"| node_tabs
node_ui -->|"submits address"| node_navigation
node_navigation -->|"loads URL"| node_webview
node_webview -->|"requests pages"| node_web
node_web -->|"renders content"| node_webview
node_ui -->|"opens"| node_menu
node_menu -->|"creates tabs"| node_tabs
node_menu -->|"starts private mode"| node_private
node_private -->|"opens private tabs"| node_tabs
node_ui -->|"shows blocked count"| node_blocklist
node_blocklist -.->|"blocks page requests"| node_webview
node_webview -->|"dispatches downloads"| node_downloads
node_downloads -->|"saves downloaded files"| node_devicefiles
node_webview -->|"opens fullscreen"| node_fullscreen
node_menu -->|"shares page"| node_sharing
node_sharing -.->|"shares with"| node_externalapps
node_menu -->|"opens page in"| node_externalapps

click node_ui "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_menu "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_tabs "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_navigation "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_webview "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_private "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_blocklist "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_blocklistfile "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/blocklist.txt"
click node_downloads "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_fullscreen "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"
click node_sharing "https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt"

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_ui,node_menu,node_user toneBlue
class node_tabs,node_navigation,node_webview toneAmber
class node_private,node_blocklist,node_blocklistfile toneMint
class node_downloads,node_fullscreen,node_sharing toneRose
class node_web,node_devicefiles,node_externalapps toneIndigo
```

## Components

### Browser interaction

- [Browser UI](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`
- [Browser menu](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`

### Page browsing

- [Tab management](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`
- [Address navigation](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`
- [WebView pages](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`

### Privacy and protection

- [Private browsing](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`
- [Tracker blocking](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`
- [Blocklist data](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/blocklist.txt): `blocklist.txt`

### Device features

- [Downloads](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`
- [Fullscreen media](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`
- [Page sharing](https://github.com/bdelectrickbill21/nirobo-browser/blob/main/MainActivity.kt): `MainActivity.kt`

### Other components

- **Browser user**
- **Websites**
- **Device file picker**
- **Other apps**

## Connections

- Browser user → Browser UI: uses (evidence: `MainActivity.kt`)
- Browser UI → Tab management: opens tabs (evidence: `MainActivity.kt`)
- Browser UI → Address navigation: submits address (evidence: `MainActivity.kt`)
- Address navigation → WebView pages: loads URL (evidence: `MainActivity.kt`)
- WebView pages → Websites: requests pages (evidence: `MainActivity.kt`)
- Websites → WebView pages: renders content (evidence: `MainActivity.kt`)
- Browser UI → Browser menu: opens (evidence: `MainActivity.kt`)
- Browser menu → Tab management: creates tabs (evidence: `MainActivity.kt`)
- Browser menu → Private browsing: starts private mode (evidence: `MainActivity.kt`)
- Private browsing → Tab management: opens private tabs (evidence: `MainActivity.kt`)
- Browser UI → Tracker blocking: shows blocked count (evidence: `MainActivity.kt`)
- Tracker blocking → WebView pages: blocks page requests (evidence: `MainActivity.kt`)
- WebView pages → Downloads: dispatches downloads (evidence: `MainActivity.kt`)
- Downloads → Device file picker: saves downloaded files (evidence: `MainActivity.kt`)
- WebView pages → Fullscreen media: opens fullscreen (evidence: `MainActivity.kt`)
- Browser menu → Page sharing: shares page (evidence: `MainActivity.kt`)
- Page sharing → Other apps: shares with
- Browser menu → Other apps: opens page in (evidence: `MainActivity.kt`)
