Skip to main content

cordova-plugin-fingerprint-aio Alternative for Capacitor

cordova-plugin-fingerprint-aio alternative for Capacitor: biometric login with @capgo/capacitor-native-biometric, secure credentials, and Face ID support.

Illustration of migrating a Cordova app to Capacitor, used for a biometric authentication plugin guide

The practical cordova-plugin-fingerprint-aio alternative for a Capacitor app is @capgo/capacitor-native-biometric. It replaces the Cordova Fingerprint object (and legacy cordova-plugin-touch-id TouchID flows on iOS) with NativeBiometric promise APIs, hardware backed credential storage, and typed BiometryType values in definitions.ts. This guide covers npm facts, install steps, usage, and an API map for your Cordova to Capacitor move.

Why leave cordova-plugin-fingerprint-aio in Capacitor

cordova-plugin-fingerprint-aio on npm is version 6.0.1. The registry modified timestamp is 28 June 2025. The source lives at niklasmerz/cordova-plugin-fingerprint-aio. The README and www/Fingerprint.js document:

  • Fingerprint.isAvailable(success, error, optionalParams)
  • Fingerprint.show(params, success, error) calling native authenticate
  • registerBiometricSecret / loadBiometricSecret for encrypted secrets (v4+)
  • Face ID support with FACEID_USAGE_DESCRIPTION install variable
  • BIOMETRIC_* error code constants in JavaScript

cordova-plugin-touch-id on npm is version 3.4.0 with modified 14 June 2022. It targets older iOS Touch ID only APIs from EddyVerbruggen/cordova-plugin-touch-id. Many apps still ship one of these Cordova plugins alongside Capacitor through compat layers.

@capgo/capacitor-native-biometric latest on npm is 8.9.3 with a modified date of 11 November 2026. src/definitions.ts documents isAvailable(), verifyIdentity(), setCredentials() / getCredentials(), getSecureCredentials(), setData() / getSecureData(), BiometryType, and AccessControl for biometric gated Keychain or Keystore access. Capgo ships fixes on an open source cadence where a human still reviews, tests and merges 50+ pull requests daily.

Install

bun add @capgo/capacitor-native-biometric
bunx cap sync

iOS: Set NSFaceIDUsageDescription in Info.plist when you use Face ID (same role as Cordova FACEID_USAGE_DESCRIPTION).

Android: Minimum SDK 23 per the Cordova README; enable USE_BIOMETRIC permissions as documented in the Capgo plugin readme.

Usage example

import { NativeBiometric, BiometryType } from '@capgo/capacitor-native-biometric';

export async function biometricUnlock() {
  const available = await NativeBiometric.isAvailable({ useFallback: true });
  if (!available.isAvailable) {
    throw new Error(`Biometrics unavailable: ${available.errorCode}`);
  }

  await NativeBiometric.verifyIdentity({
    reason: 'Confirm your identity',
    title: 'Login',
    subtitle: 'Use biometrics',
    description: available.biometryType === BiometryType.FACE_ID ? 'Face ID' : 'Biometrics',
  });
}

Migrating from Cordova to Capacitor

// Before (cordova-plugin-fingerprint-aio)
Fingerprint.show(
  { title: 'Login', clientId: 'app', clientSecret: 'unused', disableBackup: true },
  () => onSuccess(),
  (err) => onError(err),
);
// After (Capacitor)
import { NativeBiometric } from '@capgo/capacitor-native-biometric';

await NativeBiometric.verifyIdentity({
  title: 'Login',
  reason: 'Confirm your identity',
});
// Before (cordova-plugin-touch-id, iOS only)
window.plugins.touchid.isAvailable(
  () => window.plugins.touchid.verifyFingerprint('Scan to continue', onSuccess, onError),
  onError,
);
// After (Capacitor, iOS and Android)
const { isAvailable } = await NativeBiometric.isAvailable({ useFallback: false });
if (isAvailable) {
  await NativeBiometric.verifyIdentity({ reason: 'Scan to continue' });
}

API mapping table

cordova-plugin-fingerprint-aio (Fingerprint) cordova-plugin-touch-id (typical) @capgo/capacitor-native-biometric
isAvailable(success, error, optionalParams) touchid.isAvailable(success, error) isAvailable({ useFallback, preferMultipleBiometryType? }) returns AvailableResult
show(params, success, error) verifyFingerprint(message, success, error) verifyIdentity({ reason, title, subtitle, ... })
registerBiometricSecret(params, ...) not available setCredentials() or setData() with accessControl
loadBiometricSecret(params, ...) not available getSecureCredentials() or getSecureData()
BIOMETRIC_NOT_ENROLLED etc. Cordova error strings BiometricAuthError on AvailableResult.errorCode and promise rejections
Biometric type strings finger / face Touch ID only BiometryType enum (TOUCH_ID, FACE_ID, FINGERPRINT, …)
Cordova plugin install Cordova plugin install bun add @capgo/capacitor-native-biometric plus bunx cap sync

Biometric enrollment checks ship inside the native binary. Plan a store build when you change entitlements or manifest permissions. Use Capgo Build. For the full platform move, read the Cordova to Capacitor migration guide.

Live updates for Capacitor apps

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

Latest from our Blog

Capgo gives you the best insights you need to create a truly professional mobile app.