# niespodd/browser-fingerprinting architecture

> Architecture diagram of the GitHub repository niespodd/browser-fingerprinting, 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/niespodd/browser-fingerprinting
- Repository: https://github.com/niespodd/browser-fingerprinting

## Overview

The runnable product is a browser-side fingerprint tester: it probes browser and device capabilities, collects results into Redux state, and presents a report that users can inspect, hash, or share as a saved snapshot. The README is primarily an anti-bot and scraping guide; it describes detection approaches and services rather than the tester’s implementation. Probe coverage is grouped by domain; the available source excerpts do not establish every probe’s internal data flow.

Main entry points: [`tester/src/App.jsx`](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/App.jsx) (Tester dashboard), [`tester/src/testers/tester.jsx`](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/tester.jsx) (Probe runner), [`tester/src/testers/utils.jsx`](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/utils.jsx) (Probe display helpers), [`tester/src/Header.jsx`](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/Header.jsx) (Report controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["React entry<br/>[main.jsx]"]
  node_appview["Tester dashboard<br/>[App.jsx]"]
end

subgraph group_state["State and reporting"]
  node_header["Report controls<br/>[Header.jsx]"]
  node_runner["Probe runner<br/>[tester.jsx]"]
  node_actions["State actions<br/>[actions.js]"]
  node_reducers["State reducers<br/>[reducers.js]"]
  node_store["Redux store<br/>[store.js]"]
end

subgraph group_probes["Fingerprint probes"]
  node_basic["Basic information"]
  node_extensions["Extension detection"]
  node_sensors["Device sensors<br/>[DeviceSensors.jsx]"]
  node_document["Document status<br/>[DocumentStatus.jsx]"]
  node_eme["Encrypted media"]
  node_policy["Feature policy<br/>[FeaturePolicy.jsx]"]
  node_media["Media devices<br/>[MediaDevices.jsx]"]
  node_memory["Performance memory"]
  node_timing["Resource timing<br/>[ResourceTiming.jsx]"]
  node_speech["Speech synthesis"]
end

subgraph group_shared["Probe utilities"]
  node_probeutils["Probe display helpers<br/>[utils.jsx]"]
  node_base64["Snapshot encoding<br/>[base64.js]"]
  node_md5["Fingerprint hashing<br/>[md5.js]"]
end

node_browser(("Browser user"))

node_browser -->|"opens app"| node_entry
node_entry -->|"renders"| node_appview
node_appview -->|"renders"| node_header
node_appview -->|"provides state"| node_store
node_appview -->|"dispatches snapshot actions"| node_actions
node_appview -->|"renders"| node_basic
node_appview -->|"renders"| node_extensions
node_appview -->|"renders"| node_document
node_appview -->|"renders"| node_eme
node_appview -->|"renders"| node_policy
node_appview -->|"renders"| node_media
node_appview -->|"renders"| node_memory
node_appview -->|"renders"| node_timing
node_appview -->|"renders"| node_sensors
node_appview -->|"renders"| node_speech
node_appview -->|"decodes snapshot"| node_base64
node_header -->|"hashes report"| node_md5
node_header -->|"encodes snapshot"| node_base64
node_runner -->|"dispatches results"| node_actions
node_store -->|"configures reducers"| node_reducers
node_reducers -->|"handles actions"| node_actions
node_basic -->|"uses runner"| node_runner
node_extensions -->|"uses runner"| node_runner
node_sensors -->|"uses runner"| node_runner
node_document -->|"uses runner"| node_runner
node_eme -->|"uses runner"| node_runner
node_policy -->|"uses runner"| node_runner
node_media -->|"uses runner"| node_runner
node_memory -->|"uses runner"| node_runner
node_timing -->|"uses runner"| node_runner
node_speech -->|"uses runner"| node_runner
node_basic -->|"uses display helpers"| node_probeutils
node_sensors -->|"uses display helpers"| node_probeutils
node_document -->|"uses display helpers"| node_probeutils
node_eme -->|"uses display helpers"| node_probeutils
node_timing -->|"uses display helpers"| node_probeutils
node_speech -->|"uses display helpers"| node_probeutils

click node_entry "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/main.jsx"
click node_appview "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/App.jsx"
click node_header "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/Header.jsx"
click node_runner "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/tester.jsx"
click node_actions "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/state/actions.js"
click node_reducers "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/state/reducers.js"
click node_store "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/state/store.js"
click node_basic "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/BasicInformation.jsx"
click node_extensions "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/ChromeExtensions.jsx"
click node_sensors "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/DeviceSensors.jsx"
click node_document "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/DocumentStatus.jsx"
click node_eme "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/EncryptedMediaExtensions.jsx"
click node_policy "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/FeaturePolicy.jsx"
click node_media "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/MediaDevices.jsx"
click node_memory "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/PerformanceMemory.jsx"
click node_timing "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/ResourceTiming.jsx"
click node_speech "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/SpeechSynthesis.jsx"
click node_probeutils "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/utils.jsx"
click node_base64 "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/utils/base64.js"
click node_md5 "https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/utils/md5.js"

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_entry,node_appview,node_browser toneBlue
class node_header,node_runner,node_actions,node_reducers,node_store toneAmber
class node_basic,node_extensions,node_sensors,node_document,node_eme,node_policy,node_media,node_memory,node_timing,node_speech toneMint
class node_probeutils,node_base64,node_md5 toneRose
```

## Components

### Application

- [React entry](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/main.jsx): `tester/src/main.jsx`
- [Tester dashboard](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/App.jsx): `tester/src/App.jsx`

### State and reporting

- [Report controls](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/Header.jsx): `tester/src/Header.jsx`
- [Probe runner](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/tester.jsx): `tester/src/testers/tester.jsx`
- [State actions](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/state/actions.js): `tester/src/state/actions.js`
- [State reducers](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/state/reducers.js): `tester/src/state/reducers.js`
- [Redux store](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/state/store.js): `tester/src/state/store.js`

### Fingerprint probes

- [Basic information](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/BasicInformation.jsx): `tester/src/testers/BasicInformation.jsx`
- [Extension detection](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/ChromeExtensions.jsx): `tester/src/testers/ChromeExtensions.jsx`
- [Device sensors](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/DeviceSensors.jsx): `tester/src/testers/DeviceSensors.jsx`
- [Document status](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/DocumentStatus.jsx): `tester/src/testers/DocumentStatus.jsx`
- [Encrypted media](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/EncryptedMediaExtensions.jsx): `tester/src/testers/EncryptedMediaExtensions.jsx`
- [Feature policy](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/FeaturePolicy.jsx): `tester/src/testers/FeaturePolicy.jsx`
- [Media devices](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/MediaDevices.jsx): `tester/src/testers/MediaDevices.jsx`
- [Performance memory](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/PerformanceMemory.jsx): `tester/src/testers/PerformanceMemory.jsx`
- [Resource timing](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/ResourceTiming.jsx): `tester/src/testers/ResourceTiming.jsx`
- [Speech synthesis](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/SpeechSynthesis.jsx): `tester/src/testers/SpeechSynthesis.jsx`

### Probe utilities

- [Probe display helpers](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/testers/utils.jsx): `tester/src/testers/utils.jsx`
- [Snapshot encoding](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/utils/base64.js): `tester/src/utils/base64.js`
- [Fingerprint hashing](https://github.com/niespodd/browser-fingerprinting/blob/main/tester/src/utils/md5.js): `tester/src/utils/md5.js`

### Other components

- **Browser user**

## Connections

- Browser user → React entry: opens app (evidence: `tester/src/main.jsx`)
- React entry → Tester dashboard: renders (evidence: `tester/src/main.jsx`)
- Tester dashboard → Report controls: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Redux store: provides state (evidence: `tester/src/App.jsx`)
- Tester dashboard → State actions: dispatches snapshot actions (evidence: `tester/src/App.jsx`)
- Tester dashboard → Basic information: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Extension detection: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Document status: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Encrypted media: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Feature policy: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Media devices: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Performance memory: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Resource timing: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Device sensors: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Speech synthesis: renders (evidence: `tester/src/App.jsx`)
- Tester dashboard → Snapshot encoding: decodes snapshot (evidence: `tester/src/App.jsx`)
- Report controls → Fingerprint hashing: hashes report (evidence: `tester/src/Header.jsx`)
- Report controls → Snapshot encoding: encodes snapshot (evidence: `tester/src/Header.jsx`)
- Probe runner → State actions: dispatches results (evidence: `tester/src/testers/tester.jsx`)
- Redux store → State reducers: configures reducers (evidence: `tester/src/state/store.js`)
- State reducers → State actions: handles actions (evidence: `tester/src/state/reducers.js`)
- Basic information → Probe runner: uses runner (evidence: `tester/src/testers/BasicInformation.jsx`)
- Extension detection → Probe runner: uses runner (evidence: `tester/src/testers/ChromeExtensions.jsx`)
- Device sensors → Probe runner: uses runner (evidence: `tester/src/testers/DeviceSensors.jsx`)
- Document status → Probe runner: uses runner (evidence: `tester/src/testers/DocumentStatus.jsx`)
- Encrypted media → Probe runner: uses runner (evidence: `tester/src/testers/EncryptedMediaExtensions.jsx`)
- Feature policy → Probe runner: uses runner (evidence: `tester/src/testers/FeaturePolicy.jsx`)
- Media devices → Probe runner: uses runner (evidence: `tester/src/testers/MediaDevices.jsx`)
- Performance memory → Probe runner: uses runner (evidence: `tester/src/testers/PerformanceMemory.jsx`)
- Resource timing → Probe runner: uses runner (evidence: `tester/src/testers/ResourceTiming.jsx`)
- Speech synthesis → Probe runner: uses runner (evidence: `tester/src/testers/SpeechSynthesis.jsx`)
- Basic information → Probe display helpers: uses display helpers (evidence: `tester/src/testers/BasicInformation.jsx`)
- Device sensors → Probe display helpers: uses display helpers (evidence: `tester/src/testers/DeviceSensors.jsx`)
- Document status → Probe display helpers: uses display helpers (evidence: `tester/src/testers/DocumentStatus.jsx`)
- Encrypted media → Probe display helpers: uses display helpers (evidence: `tester/src/testers/EncryptedMediaExtensions.jsx`)
- Resource timing → Probe display helpers: uses display helpers (evidence: `tester/src/testers/ResourceTiming.jsx`)
- Speech synthesis → Probe display helpers: uses display helpers (evidence: `tester/src/testers/SpeechSynthesis.jsx`)
