# wix-incubator/detox-inspector architecture

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

- Interactive diagram: https://gitdiagram.com/wix-incubator/detox-inspector
- Repository: https://github.com/wix-incubator/detox-inspector

## Overview

Detox Inspector is an Android library for inspecting an app’s active UI hierarchy. Users launch its inspector through the documented adb command or Quick Settings tile; the library tracks the prior active Activity, extracts its visible views into a tree, and presents that tree for browsing, searching, and selection. The sample app also exposes a keyboard shortcut. UI details are partly based on the source index; unsampled dialog behavior is not expanded beyond its documented module relationship.

Main entry points: [`inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt`](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt) (Inspector screen), [`inspector/src/main/java/com/wix/detox/inspector/di/DI.kt`](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/di/DI.kt) (Repository wiring), [`inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepositoryImpl.kt`](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepositoryImpl.kt) (View hierarchy extraction), [`inspector/src/main/java/com/wix/detox/inspector/features/inspect/InspectActivity.kt`](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/InspectActivity.kt) (Inspector Activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Setup and launch"]
  node_init["Inspector initialization<br/>[Inspector.kt]"]
  node_provider["Startup provider"]
  node_tile["Inspector tile"]
end

subgraph group_capture["Activity and view capture"]
  node_di["Repository wiring<br/>[DI.kt]"]
  node_activity_repo["Active Activity tracking"]
  node_activity_contract["Activity repository contract"]
  node_view_repo["View hierarchy extraction"]
  node_view_contract["View tree model"]
end

subgraph group_inspect["Inspection interface"]
  node_inspect_activity["Inspector Activity<br/>[InspectActivity.kt]"]
  node_viewmodel["Inspection state and search"]
  node_screen["Inspector screen<br/>[InspectorScreen.kt]"]
  node_dialog["Node detail dialog<br/>[InspectorDialog.kt]"]
  node_search["Search controls<br/>[InspectorSearch.kt]"]
  node_theme["Inspector theme<br/>[Color.kt]"]
end

subgraph group_sample["Sample app"]
  node_sample_app["Sample app activity<br/>[MainActivity.kt]"]
end

node_user(("App developer / user"))
node_adb(("ADB launcher"))
node_quicksettings(("Quick Settings"))

node_user -->|"integrates library"| node_provider
node_provider -->|"initializes"| node_init
node_user -->|"launches with"| node_adb
node_adb -->|"starts"| node_inspect_activity
node_quicksettings -->|"clicks tile"| node_tile
node_tile -->|"starts"| node_inspect_activity
node_init -->|"registers callbacks via"| node_di
node_di -->|"provides"| node_activity_repo
node_di -->|"provides"| node_view_repo
node_activity_repo -->|"implements"| node_activity_contract
node_view_repo -->|"reads active Activity"| node_activity_repo
node_view_repo -->|"produces view tree"| node_view_contract
node_viewmodel -->|"gets repository from"| node_di
node_viewmodel -->|"observes hierarchy"| node_view_repo
node_inspect_activity -->|"owns"| node_viewmodel
node_inspect_activity -->|"renders"| node_screen
node_screen -->|"observes state"| node_viewmodel
node_screen -->|"uses"| node_dialog
node_screen -->|"uses"| node_search
node_screen -->|"uses colors"| node_theme
node_sample_app -->|"invokes inspector"| node_init

click node_init "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/Inspector.kt"
click node_provider "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/provider/InitContentProvider.kt"
click node_tile "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/service/InspectorTileService.kt"
click node_inspect_activity "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/InspectActivity.kt"
click node_di "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/di/DI.kt"
click node_activity_repo "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveActivityRepositoryImpl.kt"
click node_activity_contract "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveActivityRepository.kt"
click node_view_repo "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepositoryImpl.kt"
click node_view_contract "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepository.kt"
click node_viewmodel "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/viewmodel/InspectViewModel.kt"
click node_screen "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt"
click node_dialog "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorDialog.kt"
click node_search "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorSearch.kt"
click node_theme "https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/ui/theme/Color.kt"
click node_sample_app "https://github.com/wix-incubator/detox-inspector/blob/master/app/src/main/java/com/wix/detox/layoutinspectorapp/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_init,node_provider,node_tile,node_user toneBlue
class node_di,node_activity_repo,node_activity_contract,node_view_repo,node_view_contract toneAmber
class node_inspect_activity,node_viewmodel,node_screen,node_dialog,node_search,node_theme toneMint
class node_sample_app toneRose
class node_adb,node_quicksettings toneIndigo
```

## Components

### Setup and launch

- [Inspector initialization](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/Inspector.kt): `inspector/src/main/java/com/wix/detox/inspector/Inspector.kt`
- [Startup provider](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/provider/InitContentProvider.kt): `inspector/src/main/java/com/wix/detox/inspector/provider/InitContentProvider.kt`
- [Inspector tile](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/service/InspectorTileService.kt): `inspector/src/main/java/com/wix/detox/inspector/service/InspectorTileService.kt`

### Activity and view capture

- [Repository wiring](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/di/DI.kt): `inspector/src/main/java/com/wix/detox/inspector/di/DI.kt`
- [Active Activity tracking](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveActivityRepositoryImpl.kt): `inspector/src/main/java/com/wix/detox/inspector/repository/ActiveActivityRepositoryImpl.kt`
- [Activity repository contract](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveActivityRepository.kt): `inspector/src/main/java/com/wix/detox/inspector/repository/ActiveActivityRepository.kt`
- [View hierarchy extraction](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepositoryImpl.kt): `inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepositoryImpl.kt`
- [View tree model](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepository.kt): `inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepository.kt`

### Inspection interface

- [Inspector Activity](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/InspectActivity.kt): `inspector/src/main/java/com/wix/detox/inspector/features/inspect/InspectActivity.kt`
- [Inspection state and search](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/viewmodel/InspectViewModel.kt): `inspector/src/main/java/com/wix/detox/inspector/features/inspect/viewmodel/InspectViewModel.kt`
- [Inspector screen](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt): `inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt`
- [Node detail dialog](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorDialog.kt): `inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorDialog.kt`
- [Search controls](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorSearch.kt): `inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorSearch.kt`
- [Inspector theme](https://github.com/wix-incubator/detox-inspector/blob/master/inspector/src/main/java/com/wix/detox/inspector/ui/theme/Color.kt): `inspector/src/main/java/com/wix/detox/inspector/ui/theme/Color.kt`

### Sample app

- [Sample app activity](https://github.com/wix-incubator/detox-inspector/blob/master/app/src/main/java/com/wix/detox/layoutinspectorapp/MainActivity.kt): `app/src/main/java/com/wix/detox/layoutinspectorapp/MainActivity.kt`

### Other components

- **App developer / user**
- **ADB launcher**
- **Quick Settings**

## Connections

- App developer / user → Startup provider: integrates library (evidence: `README.md`)
- Startup provider → Inspector initialization: initializes (evidence: `inspector/src/main/java/com/wix/detox/inspector/provider/InitContentProvider.kt`)
- App developer / user → ADB launcher: launches with (evidence: `README.md`)
- ADB launcher → Inspector Activity: starts (evidence: `README.md`)
- Quick Settings → Inspector tile: clicks tile (evidence: `README.md`)
- Inspector tile → Inspector Activity: starts (evidence: `inspector/src/main/java/com/wix/detox/inspector/service/InspectorTileService.kt`)
- Inspector initialization → Repository wiring: registers callbacks via (evidence: `inspector/src/main/java/com/wix/detox/inspector/Inspector.kt`)
- Repository wiring → Active Activity tracking: provides (evidence: `inspector/src/main/java/com/wix/detox/inspector/di/DI.kt`)
- Repository wiring → View hierarchy extraction: provides (evidence: `inspector/src/main/java/com/wix/detox/inspector/di/DI.kt`)
- Active Activity tracking → Activity repository contract: implements (evidence: `inspector/src/main/java/com/wix/detox/inspector/repository/ActiveActivityRepositoryImpl.kt`)
- View hierarchy extraction → Active Activity tracking: reads active Activity (evidence: `inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepositoryImpl.kt`)
- View hierarchy extraction → View tree model: produces view tree (evidence: `inspector/src/main/java/com/wix/detox/inspector/repository/ActiveViewRepositoryImpl.kt`)
- Inspection state and search → Repository wiring: gets repository from (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/viewmodel/InspectViewModel.kt`)
- Inspection state and search → View hierarchy extraction: observes hierarchy (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/viewmodel/InspectViewModel.kt`)
- Inspector Activity → Inspection state and search: owns (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/InspectActivity.kt`)
- Inspector Activity → Inspector screen: renders (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/InspectActivity.kt`)
- Inspector screen → Inspection state and search: observes state (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt`)
- Inspector screen → Node detail dialog: uses (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt`)
- Inspector screen → Search controls: uses (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt`)
- Inspector screen → Inspector theme: uses colors (evidence: `inspector/src/main/java/com/wix/detox/inspector/features/inspect/ui/InspectorScreen.kt`)
- Sample app activity → Inspector initialization: invokes inspector (evidence: `app/src/main/java/com/wix/detox/layoutinspectorapp/MainActivity.kt`)
