# devhamzz/brave-core architecture

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

- Interactive diagram: https://gitdiagram.com/devhamzz/brave-core
- Repository: https://github.com/devhamzz/brave-core

## Overview

Brave Core is the browser-specific layer that customizes Chromium; the README also identifies an ad-block engine integration. The tree shows substantial browser features across desktop, Android, and iOS, including search, wallet, rewards, news, tabs, storage, and VPN. The graph represents these as product subsystems, not the repository’s build and synchronization tooling. Most feature implementations were not sampled, so their connections are omitted or shown as unverified rather than inferred from directory names.

Main entry points: [`android/java/org/chromium/chrome/browser/settings/BraveSearchEnginesPreferences.java`](https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/settings/BraveSearchEnginesPreferences.java) (Search settings), [`browser/custom_search_engines/android/java/src/org/chromium/brave/browser/custom_search_engines/CustomSearchEnginesManager.java`](https://github.com/devhamzz/brave-core/blob/master/browser/custom_search_engines/android/java/src/org/chromium/brave/browser/custom_search_engines/CustomSearchEnginesManager.java) (Custom engines), [`android/java/org/chromium/chrome/browser/search_engines/settings/BraveSearchEngineAdapter.java`](https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/search_engines/settings/BraveSearchEngineAdapter.java) (Search adapter), [`browser/quick_search_engines/android/java/src/org/chromium/brave/browser/quick_search_engines/utils/QuickSearchEnginesUtil.java`](https://github.com/devhamzz/brave-core/blob/master/browser/quick_search_engines/android/java/src/org/chromium/brave/browser/quick_search_engines/utils/QuickSearchEnginesUtil.java) (Quick search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Search Experience"]
  node_search_settings["Search settings"]
  node_search_adapter["Search adapter"]
  node_custom_search["Custom engines"]
  node_quick_search["Quick search"]
  node_ntp_picker["New tab picker"]
  node_ntp_engine_state["Engine preferences<br/>[EngineContext.tsx]"]
  node_search_state["New tab search state<br/>[search_store.ts]"]
end

subgraph group_protection["Privacy and Protection"]
  node_adblock_ios["iOS ad blocking"]
  node_ephemeral_storage["Ephemeral storage"]
  node_partitioned_storage["Partitioned storage UI"]
end

subgraph group_browser["Browser Features"]
  node_tab_management["Tab management"]
  node_news["Brave News"]
end

subgraph group_services["Wallet and Services"]
  node_wallet["Crypto wallet"]
  node_rewards["Brave Rewards"]
end

subgraph group_ios["iOS Features"]
  node_vpn["Brave VPN<br/>[BraveVPN.swift]"]
  node_app_review["App review criteria"]
end

node_user(("Browser user"))

node_user -.->|"configures search"| node_search_settings
node_search_settings -->|"uses adapter"| node_search_adapter
node_search_settings -->|"adds preference"| node_custom_search
node_custom_search -.->|"selects engines"| node_search_adapter
node_quick_search -->|"uses manager"| node_custom_search
node_quick_search -->|"uses adapter"| node_search_adapter
node_ntp_picker -->|"reads state"| node_search_state
node_ntp_engine_state -.->|"stores preference"| node_search_state
node_user -.->|"uses browser"| node_adblock_ios
node_adblock_ios -.->|"blocks content"| node_user
node_user -.->|"browses privately"| node_ephemeral_storage
node_user -.->|"views storage status"| node_partitioned_storage
node_user -.->|"manages tabs"| node_tab_management
node_user -.->|"reads news"| node_news
node_user -.->|"uses wallet"| node_wallet
node_user -.->|"uses rewards"| node_rewards
node_user -.->|"uses VPN"| node_vpn
node_app_review -->|"checks subscription"| node_vpn

click node_search_settings "https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/settings/BraveSearchEnginesPreferences.java"
click node_search_adapter "https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/search_engines/settings/BraveSearchEngineAdapter.java"
click node_custom_search "https://github.com/devhamzz/brave-core/blob/master/browser/custom_search_engines/android/java/src/org/chromium/brave/browser/custom_search_engines/CustomSearchEnginesManager.java"
click node_quick_search "https://github.com/devhamzz/brave-core/blob/master/browser/quick_search_engines/android/java/src/org/chromium/brave/browser/quick_search_engines/utils/QuickSearchEnginesUtil.java"
click node_ntp_picker "https://github.com/devhamzz/brave-core/blob/master/browser/resources/brave_new_tab_page_refresh/components/search/search_engine_picker.tsx"
click node_ntp_engine_state "https://github.com/devhamzz/brave-core/blob/master/components/brave_new_tab_ui/components/search/EngineContext.tsx"
click node_search_state "https://github.com/devhamzz/brave-core/blob/master/browser/resources/brave_new_tab_page_refresh/state/search_store.ts"
click node_adblock_ios "https://github.com/devhamzz/brave-core/blob/master/ios/brave-ios/Sources/Brave/WebFilters/AdBlock/AdBlockEngineManager.swift"
click node_ephemeral_storage "https://github.com/devhamzz/brave-core/blob/master/components/ephemeral_storage/ephemeral_storage_service.cc"
click node_partitioned_storage "https://github.com/devhamzz/brave-core/blob/master/browser/ui/views/page_action/partitioned_storage_page_action_controller.cc"
click node_tab_management "https://github.com/devhamzz/brave-core/blob/master/android/features/tab_ui/java/src/org/chromium/chrome/browser/tasks/tab_management/BraveTabGroupUiCoordinator.java"
click node_news "https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/brave_news/BraveNewsControllerFactory.java"
click node_wallet "https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/crypto_wallet/activities/BraveWalletActivity.java"
click node_rewards "https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/BraveRewardsNativeWorker.java"
click node_vpn "https://github.com/devhamzz/brave-core/blob/master/ios/brave-ios/Sources/BraveVPN/BraveVPN.swift"
click node_app_review "https://github.com/devhamzz/brave-core/blob/master/ios/brave-ios/Sources/Growth/AppReviewManager.swift"

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_search_settings,node_search_adapter,node_custom_search,node_quick_search,node_ntp_picker,node_ntp_engine_state,node_search_state,node_user toneBlue
class node_adblock_ios,node_ephemeral_storage,node_partitioned_storage toneAmber
class node_tab_management,node_news toneMint
class node_wallet,node_rewards toneRose
class node_vpn,node_app_review toneIndigo
```

## Components

### Search Experience

- [Search settings](https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/settings/BraveSearchEnginesPreferences.java): `android/java/org/chromium/chrome/browser/settings/BraveSearchEnginesPreferences.java`
- [Search adapter](https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/search_engines/settings/BraveSearchEngineAdapter.java): `android/java/org/chromium/chrome/browser/search_engines/settings/BraveSearchEngineAdapter.java`
- [Custom engines](https://github.com/devhamzz/brave-core/blob/master/browser/custom_search_engines/android/java/src/org/chromium/brave/browser/custom_search_engines/CustomSearchEnginesManager.java): `browser/custom_search_engines/android/java/src/org/chromium/brave/browser/custom_search_engines/CustomSearchEnginesManager.java`
- [Quick search](https://github.com/devhamzz/brave-core/blob/master/browser/quick_search_engines/android/java/src/org/chromium/brave/browser/quick_search_engines/utils/QuickSearchEnginesUtil.java): `browser/quick_search_engines/android/java/src/org/chromium/brave/browser/quick_search_engines/utils/QuickSearchEnginesUtil.java`
- [New tab picker](https://github.com/devhamzz/brave-core/blob/master/browser/resources/brave_new_tab_page_refresh/components/search/search_engine_picker.tsx): `browser/resources/brave_new_tab_page_refresh/components/search/search_engine_picker.tsx`
- [Engine preferences](https://github.com/devhamzz/brave-core/blob/master/components/brave_new_tab_ui/components/search/EngineContext.tsx): `components/brave_new_tab_ui/components/search/EngineContext.tsx`
- [New tab search state](https://github.com/devhamzz/brave-core/blob/master/browser/resources/brave_new_tab_page_refresh/state/search_store.ts): `browser/resources/brave_new_tab_page_refresh/state/search_store.ts`

### Privacy and Protection

- [iOS ad blocking](https://github.com/devhamzz/brave-core/blob/master/ios/brave-ios/Sources/Brave/WebFilters/AdBlock/AdBlockEngineManager.swift): `ios/brave-ios/Sources/Brave/WebFilters/AdBlock/AdBlockEngineManager.swift`
- [Ephemeral storage](https://github.com/devhamzz/brave-core/blob/master/components/ephemeral_storage/ephemeral_storage_service.cc): `components/ephemeral_storage/ephemeral_storage_service.cc`
- [Partitioned storage UI](https://github.com/devhamzz/brave-core/blob/master/browser/ui/views/page_action/partitioned_storage_page_action_controller.cc): `browser/ui/views/page_action/partitioned_storage_page_action_controller.cc`

### Browser Features

- [Tab management](https://github.com/devhamzz/brave-core/blob/master/android/features/tab_ui/java/src/org/chromium/chrome/browser/tasks/tab_management/BraveTabGroupUiCoordinator.java): `android/features/tab_ui/java/src/org/chromium/chrome/browser/tasks/tab_management/BraveTabGroupUiCoordinator.java`
- [Brave News](https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/brave_news/BraveNewsControllerFactory.java): `android/java/org/chromium/chrome/browser/brave_news/BraveNewsControllerFactory.java`

### Wallet and Services

- [Crypto wallet](https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/crypto_wallet/activities/BraveWalletActivity.java): `android/java/org/chromium/chrome/browser/crypto_wallet/activities/BraveWalletActivity.java`
- [Brave Rewards](https://github.com/devhamzz/brave-core/blob/master/android/java/org/chromium/chrome/browser/BraveRewardsNativeWorker.java): `android/java/org/chromium/chrome/browser/BraveRewardsNativeWorker.java`

### iOS Features

- [Brave VPN](https://github.com/devhamzz/brave-core/blob/master/ios/brave-ios/Sources/BraveVPN/BraveVPN.swift): `ios/brave-ios/Sources/BraveVPN/BraveVPN.swift`
- [App review criteria](https://github.com/devhamzz/brave-core/blob/master/ios/brave-ios/Sources/Growth/AppReviewManager.swift): `ios/brave-ios/Sources/Growth/AppReviewManager.swift`

### Other components

- **Browser user**

## Connections

- Browser user → Search settings: configures search
- Search settings → Search adapter: uses adapter (evidence: `android/java/org/chromium/chrome/browser/settings/BraveSearchEnginesPreferences.java`)
- Search settings → Custom engines: adds preference (evidence: `android/java/org/chromium/chrome/browser/settings/BraveSearchEnginesPreferences.java`)
- Custom engines → Search adapter: selects engines
- Quick search → Custom engines: uses manager (evidence: `browser/quick_search_engines/android/java/src/org/chromium/brave/browser/quick_search_engines/utils/QuickSearchEnginesUtil.java`)
- Quick search → Search adapter: uses adapter (evidence: `browser/quick_search_engines/android/java/src/org/chromium/brave/browser/quick_search_engines/utils/QuickSearchEnginesUtil.java`)
- New tab picker → New tab search state: reads state (evidence: `browser/resources/brave_new_tab_page_refresh/components/search/search_engine_picker.tsx`)
- Engine preferences → New tab search state: stores preference
- Browser user → iOS ad blocking: uses browser
- iOS ad blocking → Browser user: blocks content
- Browser user → Ephemeral storage: browses privately
- Browser user → Partitioned storage UI: views storage status
- Browser user → Tab management: manages tabs
- Browser user → Brave News: reads news
- Browser user → Crypto wallet: uses wallet
- Browser user → Brave Rewards: uses rewards
- Browser user → Brave VPN: uses VPN
- App review criteria → Brave VPN: checks subscription (evidence: `ios/brave-ios/Sources/Growth/AppReviewManager.swift`)
