How fingerprintjs/flutter works
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: fingerprint_native.dart Fingerprint Client · FingerprintHostApiImpl.kt Android Host · FingerprintHostApiImpl.swift iOS Host · fingerprint_platform_interface.dart Platform Interface
Components 24
Dart SDK
- Fingerprint Client
lib/src/fingerprint_native.dart - Platform Interface
lib/src/fingerprint_platform_interface.dart - Options
lib/src/options.dart - Input Validation
lib/src/validation.dart - Regions
lib/src/region.dart - Identification Result
lib/src/fingerprint_result.dart - Fingerprint Error
lib/src/fingerprint_error.dart - Public API
lib/fingerprint_flutter.dart
Flutter Bridge
- Dart Message API
lib/src/pigeon/fingerprint_api.g.dart - Android Plugin
android/src/main/kotlin/com/fingerprint/flutter/FingerprintPlugin.kt - Android Message API
android/src/main/kotlin/com/fingerprint/flutter/FingerprintApi.g.kt - iOS Plugin
ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintPlugin.swift - iOS Message API
ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintApi.g.swift
Native Platforms
- Android Host
android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt - Android Client Cache
android/src/main/kotlin/com/fingerprint/flutter/FingerprintClientCache.kt - iOS Host
ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift - iOS Client Cache
ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintClientCache.swift
Web Agent
- Web Implementation
lib/src/fingerprint_web.dart - JavaScript Interop
lib/src/js_agent_interop.dart - Agent Loader
web/index.js - Agent Entry
web/index.ts
Other components
- Flutter App
- Fingerprint Native SDKs
- Fingerprint JS Agent
Connections 23
- Flutter App → Fingerprint Client: configures and calls
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
README.md - Fingerprint Client → Fingerprint Error: throws errors
README.md - Public API → Fingerprint Client: exposes
- Platform Interface → Dart Message API: dispatches messages
- Android Plugin → Android Message API: registers handler
android/src/main/kotlin/com/fingerprint/flutter/FingerprintPlugin.kt - Android Message API → Android Host: routes messages
- iOS Plugin → iOS Message API: registers handler
ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintPlugin.swift - iOS Message API → iOS Host: routes messages
- Android Host → Android Client Cache: gets client
android/src/main/kotlin/com/fingerprint/flutter/FingerprintHostApiImpl.kt - iOS Host → iOS Client Cache: gets client
ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintHostApiImpl.swift - Android Client Cache → Fingerprint Native SDKs: creates clients
- iOS Client Cache → Fingerprint Native SDKs: creates clients
ios/fingerprint_flutter/Sources/fingerprint_flutter/FingerprintClientCache.swift - Android Host → Fingerprint Native SDKs: requests visitor ID
- iOS Host → Fingerprint Native SDKs: requests visitor ID
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
web/index.ts