Flutter Biometric Auth Plus #

Enhanced biometric authentication with fallback options and better error handling for Flutter applications. Now with full platform support and custom implementation!

🚀 What's New in v0.0.2 #

• ✅ Complete rewrite: Removed dependency on local_auth package
• ✅ Custom implementation: Platform-specific native code for each platform
• ✅ Full platform support: All 6 platforms (iOS, Android, Web, Windows, macOS, Linux)
• ✅ WASM compatibility: Fully compatible with web/WASM runtime
• ✅ Perfect score: 160/160 points in Pana analysis

🌟 Features #

• 🔐 Multi-platform biometric authentication
• 📱 Platform-specific native implementations
• 🌐 Web/WASM compatibility
• 🔄 Automatic fallback mechanisms
• ⚡ Enhanced error handling
• 🎯 Type-safe API design
• 📚 Comprehensive documentation

📱 Platform Support #

🚀 Quick Start #

1. Add Dependency #

dependencies:
  flutter_biometric_auth_plus: ^0.0.2

2. Import Package #

import 'package:flutter_biometric_auth_plus/flutter_biometric_auth_plus.dart';

3. Check Biometric Availability #

// Check if biometrics are available
final bool isAvailable = await BiometricAuth.isBiometricsAvailable();

// Get available biometric types
final List<BiometricAuthType> biometrics = 
    await BiometricAuth.getAvailableBiometrics();

4. Authenticate #

// Basic authentication
final AuthResult result = await BiometricAuth.authenticate(
  reason: 'Please authenticate to access the app',
);

if (result.isSuccess) {
  print('Authentication successful!');
} else {
  print('Authentication failed: ${result.data?['reason']}');
}

5. Authentication with Fallback #

// Try biometrics first, fallback to passcode
final AuthResult result = await BiometricAuth.authenticateWithFallback(
  reason: 'Please authenticate to access the app',
);

if (result.isSuccess) {
  if (result.data?['fallbackUsed'] == true) {
    print('Authenticated using device passcode');
  } else {
    print('Authenticated using biometrics');
  }
}

🔧 Advanced Usage #

Check Device Support #

final bool isSupported = await BiometricAuth.isDeviceSupported();
final String strength = await BiometricAuth.getBiometricStrength();

Handle Different Biometric Types #

final List<BiometricAuthType> availableBiometrics = 
    await BiometricAuth.getAvailableBiometrics();

for (final type in availableBiometrics) {
  print('Available: ${type.displayName} (${type.identifier})');
}

Custom Error Handling #

try {
  final result = await BiometricAuth.authenticate(
    reason: 'Please authenticate',
  );
  // Handle success
} on BiometricException catch (e) {
  switch (e.code) {
    case 'BIOMETRICS_NOT_AVAILABLE':
      print('Biometrics not available: ${e.message}');
      break;
    case 'AUTHENTICATION_FAILED':
      print('Authentication failed: ${e.message}');
      break;
    case 'PERMISSION_DENIED':
      print('Permission denied: ${e.message}');
      break;
  }
}

🏗️ Architecture #

This package uses a platform-agnostic approach with automatic fallback:

┌─────────────────────────────────────────────────────────────┐
│                    BiometricAuth Class                     │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────────┐  ┌─────────────────────────────────┐  │
│  │   Native Impl   │  │        Stub Impl               │  │
│  │                 │  │                                 │  │
│  │ • Android       │  │ • Web/WASM Compatible          │  │
│  │ • iOS           │  │ • WebAuthn API                 │  │
│  │ • Windows       │  │ • Fallback Implementation      │  │
│  │ • macOS         │  │                                 │  │
│  │ • Linux         │  │                                 │  │
│  └─────────────────┘  └─────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

🔄 Migration from local_auth #

If you're migrating from the local_auth package:

Before (local_auth) #

import 'package:local_auth/local_auth.dart';

final LocalAuthentication auth = LocalAuthentication();
final bool canAuthenticate = await auth.canCheckBiometrics;

After (flutter_biometric_auth_plus) #

import 'package:flutter_biometric_auth_plus/flutter_biometric_auth_plus.dart';

final bool canAuthenticate = await BiometricAuth.isBiometricsAvailable();

Benefits of migration:

• ✅ Full platform support (was limited to 4/6 platforms)
• ✅ WASM compatibility (was not compatible)
• ✅ No external dependencies (was dependent on local_auth)
• ✅ Better error handling (enhanced error messages)
• ✅ Automatic fallback (seamless platform switching)

📋 Requirements #

• Flutter: >=3.10.0
• Dart: >=3.0.0
• Platforms: iOS 9.0+, Android 6.0+, Web, Windows 10+, macOS 10.14+, Linux

🔒 Permissions #

Android #

Add to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.USE_BIOMETRIC" />
<uses-permission android:name="android.permission.USE_FINGERPRINT" />

iOS #

Add to ios/Runner/Info.plist:

<key>NSFaceIDUsageDescription</key>
<string>This app uses Face ID for secure authentication.</string>

🧪 Testing #

Run the test suite:

flutter test

Run analysis:

flutter analyze
dart analyze

📊 Quality Metrics #

• Pana Score: 160/160 (100%) ✅
• Test Coverage: 15/15 tests passing ✅
• Analysis: No issues found ✅
• Documentation: 95.3% API coverage ✅
• Platform Support: 6/6 platforms ✅
• WASM Compatibility: Full support ✅

🤝 Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments #

• Flutter Team for the amazing framework
• Dart Team for the powerful language
• Community for feedback and contributions

Made with ❤️ for the Flutter community

This package is a complete rewrite that removes dependency on external biometric packages and provides full platform support with custom implementations.