# fingerprintjs/flutter architecture

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

- Interactive diagram: https://gitdiagram.com/fingerprintjs/flutter
- Repository: https://github.com/fingerprintjs/flutter

## Overview

Fingerprint Flutter is a cross-platform Flutter SDK for creating a configured Fingerprint client and retrieving visitor-identification results. The documented path is Flutter app → client configuration and `get` options → platform bridge → Android/iOS Fingerprint SDK or web JavaScript agent → result or error. Android and iOS host implementations cache clients by configuration and translate identification responses. The README also documents custom endpoints, region selection, linked IDs, tags, timeouts, location options, and web caching. Dart internals and some web wiring are unsampled, so uncertain connections are omitted or shown as unverified.

Main entry points: [`lib/src/fingerprint_native.dart`](https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_native.dart) (Fingerprint Client), [`android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt`](https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt) (Android Host), [`ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift`](https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift) (iOS Host), [`lib/src/fingerprint_platform_interface.dart`](https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_platform_interface.dart) (Platform Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dart_api["Dart SDK"]
  node_client["Fingerprint Client"]
  node_platform_api["Platform Interface"]
  node_options["Options<br/>[options.dart]"]
  node_validation["Input Validation<br/>[validation.dart]"]
  node_region["Regions<br/>[region.dart]"]
  node_result["Identification Result"]
  node_error["Fingerprint Error"]
  node_public_api["Public API"]
end

subgraph group_bridge["Flutter Bridge"]
  node_pigeon_dart["Dart Message API"]
  node_android_plugin["Android Plugin"]
  node_android_api["Android Message API"]
  node_ios_plugin["iOS Plugin"]
  node_ios_api["iOS Message API"]
end

subgraph group_native["Native Platforms"]
  node_android_host["Android Host"]
  node_android_cache[("Android Client Cache")]
  node_ios_host["iOS Host"]
  node_ios_cache[("iOS Client Cache")]
end

subgraph group_web["Web Agent"]
  node_web_impl["Web Implementation"]
  node_web_interop["JavaScript Interop"]
  node_web_loader["Agent Loader<br/>[index.js]"]
  node_web_entry["Agent Entry<br/>[index.ts]"]
end

node_flutter_app(("Flutter App"))
node_native_sdk{{"Fingerprint Native SDKs"}}
node_js_agent{{"Fingerprint JS Agent"}}

node_flutter_app -.->|"configures and calls"| node_client
node_client -.->|"requests identification"| node_platform_api
node_client -.->|"accepts options"| node_options
node_client -.->|"validates inputs"| node_validation
node_client -.->|"uses region"| node_region
node_client -.->|"returns result"| node_result
node_client -.->|"throws errors"| node_error
node_public_api -.->|"exposes"| node_client
node_platform_api -.->|"dispatches messages"| node_pigeon_dart
node_android_plugin -->|"registers handler"| node_android_api
node_android_api -->|"routes messages"| node_android_host
node_ios_plugin -->|"registers handler"| node_ios_api
node_ios_api -->|"routes messages"| node_ios_host
node_android_host -->|"gets client"| node_android_cache
node_ios_host -->|"gets client"| node_ios_cache
node_android_cache -.->|"creates clients"| node_native_sdk
node_ios_cache -->|"creates clients"| node_native_sdk
node_android_host -.->|"requests visitor ID"| node_native_sdk
node_ios_host -->|"requests visitor ID"| node_native_sdk
node_web_impl -.->|"uses interop"| node_web_interop
node_web_interop -.->|"invokes loader"| node_web_loader
node_web_loader -.->|"loads agent"| node_web_entry
node_web_entry -->|"starts agent"| node_js_agent

click node_client "https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_native.dart"
click node_platform_api "https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_platform_interface.dart"
click node_options "https://github.com/fingerprintjs/flutter/blob/main/lib/src/options.dart"
click node_validation "https://github.com/fingerprintjs/flutter/blob/main/lib/src/validation.dart"
click node_region "https://github.com/fingerprintjs/flutter/blob/main/lib/src/region.dart"
click node_result "https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_result.dart"
click node_error "https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_error.dart"
click node_public_api "https://github.com/fingerprintjs/flutter/blob/main/lib/fingerprint_flutter.dart"
click node_pigeon_dart "https://github.com/fingerprintjs/flutter/blob/main/lib/src/pigeon/fingerprint_api.g.dart"
click node_android_plugin "https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintPlugin.kt"
click node_android_api "https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintApi.g.kt"
click node_ios_plugin "https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintPlugin.swift"
click node_ios_api "https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintApi.g.swift"
click node_android_host "https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt"
click node_android_cache "https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintClientCache.kt"
click node_ios_host "https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift"
click node_ios_cache "https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintClientCache.swift"
click node_web_impl "https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_web.dart"
click node_web_interop "https://github.com/fingerprintjs/flutter/blob/main/lib/src/js_agent_interop.dart"
click node_web_loader "https://github.com/fingerprintjs/flutter/blob/main/web/index.js"
click node_web_entry "https://github.com/fingerprintjs/flutter/blob/main/web/index.ts"

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_client,node_platform_api,node_options,node_validation,node_region,node_result,node_error,node_public_api toneBlue
class node_pigeon_dart,node_android_plugin,node_android_api,node_ios_plugin,node_ios_api toneAmber
class node_android_host,node_android_cache,node_ios_host,node_ios_cache toneMint
class node_web_impl,node_web_interop,node_web_loader,node_web_entry toneRose
class node_flutter_app,node_native_sdk,node_js_agent toneIndigo
```

## Components

### Dart SDK

- [Fingerprint Client](https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_native.dart): `lib/src/fingerprint_native.dart`
- [Platform Interface](https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_platform_interface.dart): `lib/src/fingerprint_platform_interface.dart`
- [Options](https://github.com/fingerprintjs/flutter/blob/main/lib/src/options.dart): `lib/src/options.dart`
- [Input Validation](https://github.com/fingerprintjs/flutter/blob/main/lib/src/validation.dart): `lib/src/validation.dart`
- [Regions](https://github.com/fingerprintjs/flutter/blob/main/lib/src/region.dart): `lib/src/region.dart`
- [Identification Result](https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_result.dart): `lib/src/fingerprint_result.dart`
- [Fingerprint Error](https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_error.dart): `lib/src/fingerprint_error.dart`
- [Public API](https://github.com/fingerprintjs/flutter/blob/main/lib/fingerprint_flutter.dart): `lib/fingerprint_flutter.dart`

### Flutter Bridge

- [Dart Message API](https://github.com/fingerprintjs/flutter/blob/main/lib/src/pigeon/fingerprint_api.g.dart): `lib/src/pigeon/fingerprint_api.g.dart`
- [Android Plugin](https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintPlugin.kt): `android/src/main/kotlin/com/fingerprint/flutter/FingerprintPlugin.kt`
- [Android Message API](https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintApi.g.kt): `android/src/main/kotlin/com/fingerprint/flutter/FingerprintApi.g.kt`
- [iOS Plugin](https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintPlugin.swift): `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintPlugin.swift`
- [iOS Message API](https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintApi.g.swift): `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintApi.g.swift`

### Native Platforms

- [Android Host](https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt): `android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt`
- [Android Client Cache](https://github.com/fingerprintjs/flutter/blob/main/android/src/main/kotlin/com/fingerprint/flutter/FingerprintClientCache.kt): `android/src/main/kotlin/com/fingerprint/flutter/FingerprintClientCache.kt`
- [iOS Host](https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift): `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift`
- [iOS Client Cache](https://github.com/fingerprintjs/flutter/blob/main/ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintClientCache.swift): `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintClientCache.swift`

### Web Agent

- [Web Implementation](https://github.com/fingerprintjs/flutter/blob/main/lib/src/fingerprint_web.dart): `lib/src/fingerprint_web.dart`
- [JavaScript Interop](https://github.com/fingerprintjs/flutter/blob/main/lib/src/js_agent_interop.dart): `lib/src/js_agent_interop.dart`
- [Agent Loader](https://github.com/fingerprintjs/flutter/blob/main/web/index.js): `web/index.js`
- [Agent Entry](https://github.com/fingerprintjs/flutter/blob/main/web/index.ts): `web/index.ts`

### Other components

- **Flutter App**
- **Fingerprint Native SDKs**
- **Fingerprint JS Agent**

## Connections

- Flutter App → Fingerprint Client: configures and calls (evidence: `README.md`)
- Fingerprint Client → Platform Interface: requests identification
- Fingerprint Client → Options: accepts options
- Fingerprint Client → Input Validation: validates inputs
- Fingerprint Client → Regions: uses region
- Fingerprint Client → Identification Result: returns result (evidence: `README.md`)
- Fingerprint Client → Fingerprint Error: throws errors (evidence: `README.md`)
- Public API → Fingerprint Client: exposes
- Platform Interface → Dart Message API: dispatches messages
- Android Plugin → Android Message API: registers handler (evidence: `android/src/main/kotlin/com/fingerprint/flutter/FingerprintPlugin.kt`)
- Android Message API → Android Host: routes messages
- iOS Plugin → iOS Message API: registers handler (evidence: `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintPlugin.swift`)
- iOS Message API → iOS Host: routes messages
- Android Host → Android Client Cache: gets client (evidence: `android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt`)
- iOS Host → iOS Client Cache: gets client (evidence: `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift`)
- Android Client Cache → Fingerprint Native SDKs: creates clients
- iOS Client Cache → Fingerprint Native SDKs: creates clients (evidence: `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintClientCache.swift`)
- Android Host → Fingerprint Native SDKs: requests visitor ID
- iOS Host → Fingerprint Native SDKs: requests visitor ID (evidence: `ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift`)
- Web Implementation → JavaScript Interop: uses interop
- JavaScript Interop → Agent Loader: invokes loader
- Agent Loader → Agent Entry: loads agent
- Agent Entry → Fingerprint JS Agent: starts agent (evidence: `web/index.ts`)
