docs: biometrics (#633)

Ombuweb · web-flow · commit 6201be1f0c3c · 2025-06-13T13:48:36.000-07:00
diff --git a/packages/biometrics/README.md b/packages/biometrics/README.md
@@ -23,6 +23,13 @@ A plugin that allows you to authenticate users with biometrics, such as fingerpr
 > **Note**
 This plugin replaces [@nativescript/fingerprint-auth](../fingerprint-auth).
 
+### Prerequisites:
+Before you can verify a user’s biometrics, the device must already have biometric data (such as fingerprints or a face scan) enrolled at the system level. This enrollment is handled by the device’s operating system settings—your app or this plugin does not capture or store biometric data directly. Users must set up biometrics through their device’s security settings (e.g., `Settings` > `Security` > `Biometrics` on Android, or `Settings` > `Face ID` & `Passcode` on iOS).
+
+### How it works:
+When you call the plugin’s verification methods, the plugin asks the operating system to prompt the user for their enrolled biometric (fingerprint, face, etc.) and returns the result. The plugin never sees or manages the actual biometric data—only the OS does.
+
+
 ## Installation
 
 ```cli
