Files
sure/mobile/lib/screens/biometric_lock_screen.dart
Tristan Katana 9c199a6dcd feat(mobile): Add biometric lock for app resume (#1474)
* Feature: Biometric lock for app resume

User enables "Biometric Lock" in Settings → prompted to verify fingerprint/face first.
User backgrounds the app → _isLocked = true.
User returns → lock screen appears, auto-triggers biometric prompt.
Success → app unlocks, state preserved underneath.
Can retry or log out as fallback.
Add USE_BIOMETRIC permission to AndroidManifest.

* Fix: Remove duplicate local_auth entry in pubspec.lock and add NSFaceIDUsageDescription to iOS Info.plist

* fix(mobile) : Remove duplicate local auth files first

* fix(mobile): keep MainNavigationScreen in the Stack, let the lock screen float above, no unmounting

* Updtae: Swap out Flutter Activity for FlutterFragmentActivity that extends the lock scan feature

* fix(mobile): address biometric lock PR review feedback

* fix(mobile): only require biometric auth when enabling lock, not disabling

Prevents users from getting locked out if biometrics start failing —
they can now disable the lock without needing to pass biometric auth.

* fix(mobile): add missing closing brace in setBiometricEnabled

---------

Signed-off-by: Tristan Katana <50181095+felixmuinde@users.noreply.github.com>
2026-04-15 19:48:13 +02:00

100 lines
2.9 KiB
Dart

import 'package:flutter/material.dart';
import '../services/biometric_service.dart';
class BiometricLockScreen extends StatefulWidget {
const BiometricLockScreen({
super.key,
required this.onUnlocked,
this.onLogout,
});
final VoidCallback onUnlocked;
final VoidCallback? onLogout;
@override
State<BiometricLockScreen> createState() => _BiometricLockScreenState();
}
class _BiometricLockScreenState extends State<BiometricLockScreen> {
bool _isAuthenticating = false;
@override
void initState() {
super.initState();
// Auto-trigger biometric prompt on first show.
WidgetsBinding.instance.addPostFrameCallback((_) => _authenticate());
}
Future<void> _authenticate() async {
if (!mounted || _isAuthenticating) return;
setState(() => _isAuthenticating = true);
final success = await BiometricService.instance.authenticate();
if (!mounted) return;
setState(() => _isAuthenticating = false);
if (success) {
widget.onUnlocked();
} else {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(content: Text('Authentication failed. Tap Unlock to try again.')),
);
}
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Scaffold(
body: Center(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 32),
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Icon(
Icons.lock_outline,
size: 72,
color: colorScheme.primary,
),
const SizedBox(height: 24),
Text(
'App Locked',
style: Theme.of(context).textTheme.headlineSmall?.copyWith(
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 8),
Text(
'Authenticate to continue',
style: TextStyle(color: colorScheme.onSurfaceVariant),
),
const SizedBox(height: 40),
FilledButton.icon(
onPressed: _isAuthenticating ? null : _authenticate,
icon: const Icon(Icons.fingerprint),
label: Text(_isAuthenticating ? 'Authenticating…' : 'Unlock'),
style: FilledButton.styleFrom(
minimumSize: const Size(200, 50),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(12),
),
),
),
if (widget.onLogout != null) ...[
const SizedBox(height: 16),
TextButton(
onPressed: widget.onLogout,
child: const Text('Log out'),
),
],
],
),
),
),
);
}
}