secure_content 2.0.0-beta.4

Protect Flutter screens with screenshot/recording shielding, biometric re-auth, inactivity lock, integrity checks, risk watermarks, and secure clipboard controls.

example/lib/main.dart

import 'dart:ui';

import 'package:flutter/material.dart';
import 'package:secure_content/secure_content.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'secure_content v2 example',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
      ),
      home: const HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  const HomeScreen({super.key});

  @override
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  final SecureContentController _controller = SecureContent.createController();

  bool _scopeEnabled = true;
  bool _hardBlockMode = false;
  bool _useCustomLockScreen = false;
  bool _useCustomHardBlock = false;
  int _counter = 0;
  String _lastEvent = 'No events yet';

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  Future<void> _toggleGlobalProtection() async {
    if (_controller.enabled) {
      await _controller.disable();
    } else {
      await _controller.enable(
        protectInAppSwitcher: true,
        appSwitcherColor: Colors.black,
      );
    }

    if (mounted) {
      setState(() {});
    }
  }

  Widget _buildCustomLockScreen(BuildContext context, VoidCallback onUnlock) =>
      Container(
        color: const Color(0xFF1A237E),
        child: Center(
          child: Column(
            mainAxisSize: MainAxisSize.min,
            children: [
              const Icon(Icons.security, color: Colors.amber, size: 48),
              const SizedBox(height: 16),
              const Text(
                'Session locked',
                style: TextStyle(
                  color: Colors.white,
                  fontSize: 22,
                  fontWeight: FontWeight.w600,
                ),
              ),
              const SizedBox(height: 20),
              ElevatedButton.icon(
                onPressed: onUnlock,
                icon: const Icon(Icons.fingerprint),
                label: const Text('Unlock'),
                style: ElevatedButton.styleFrom(
                  backgroundColor: Colors.amber,
                  foregroundColor: Colors.black,
                  padding: const EdgeInsets.symmetric(
                    horizontal: 32,
                    vertical: 14,
                  ),
                ),
              ),
            ],
          ),
        ),
      );

  Widget _buildCustomHardBlockScreen(BuildContext context) => Container(
    color: const Color(0xFF880E4F),
    child: Center(
      child: Padding(
        padding: const EdgeInsets.all(32),
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            const Icon(Icons.gpp_bad, color: Colors.orange, size: 56),
            const SizedBox(height: 16),
            const Text(
              'Access denied',
              textAlign: TextAlign.center,
              style: TextStyle(
                color: Colors.white,
                fontSize: 24,
                fontWeight: FontWeight.w700,
              ),
            ),
            const SizedBox(height: 12),
            Text(
              'Security violation detected.',
              textAlign: TextAlign.center,
              style: TextStyle(
                color: Colors.white.withValues(alpha: 0.8),
                fontSize: 16,
              ),
            ),
          ],
        ),
      ),
    ),
  );

  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Secure Content v2')),
    body: Padding(
      padding: const EdgeInsets.all(16),
      child: SingleChildScrollView(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.stretch,
          children: [
            Text(
              'Global protection: ${_controller.enabled ? 'ON' : 'OFF'}',
              style: Theme.of(context).textTheme.titleMedium,
            ),
            const SizedBox(height: 8),
            Text(
              'Scoped protection: ${_scopeEnabled ? 'ON' : 'OFF'}',
              style: Theme.of(context).textTheme.titleMedium,
            ),
            const SizedBox(height: 16),
            Wrap(
              spacing: 8,
              runSpacing: 8,
              children: [
                ElevatedButton(
                  onPressed: _toggleGlobalProtection,
                  child: const Text('Toggle global protection'),
                ),
                ElevatedButton(
                  onPressed: () {
                    setState(() {
                      _scopeEnabled = !_scopeEnabled;
                    });
                  },
                  child: const Text('Toggle scope protection'),
                ),
                ElevatedButton(
                  onPressed: () {
                    setState(() {
                      _counter++;
                    });
                  },
                  child: const Text('Increment secure counter'),
                ),
                ElevatedButton(
                  onPressed: () {
                    SecureContent.requestBiometricAuth(
                      reason: 'Unlock secure content',
                    );
                  },
                  child: const Text('Request biometric auth'),
                ),
                ElevatedButton(
                  onPressed: () {
                    SecureContent.checkIntegrity();
                  },
                  child: const Text('Run integrity check'),
                ),
                ElevatedButton(
                  onPressed: () {
                    SecureContent.setSensitiveClipboard(
                      'Sensitive counter=$_counter',
                      clearAfter: const Duration(seconds: 10),
                    );
                  },
                  child: const Text('Copy secure text (10s)'),
                ),
                ElevatedButton(
                  onPressed: () {
                    setState(() {
                      _hardBlockMode = !_hardBlockMode;
                    });
                  },
                  child: Text(
                    _hardBlockMode
                        ? 'Hard block mode: ON'
                        : 'Hard block mode: OFF',
                  ),
                ),
                ElevatedButton(
                  onPressed: () {
                    setState(() {
                      _useCustomLockScreen = !_useCustomLockScreen;
                    });
                  },
                  child: Text(
                    _useCustomLockScreen
                        ? 'Custom lock screen: ON'
                        : 'Custom lock screen: OFF',
                  ),
                ),
                ElevatedButton(
                  onPressed: () {
                    setState(() {
                      _useCustomHardBlock = !_useCustomHardBlock;
                    });
                  },
                  child: Text(
                    _useCustomHardBlock
                        ? 'Custom hard block: ON'
                        : 'Custom hard block: OFF',
                  ),
                ),
              ],
            ),
            const SizedBox(height: 24),
            Text(
              'Protected content area',
              style: Theme.of(context).textTheme.titleLarge,
            ),
            const SizedBox(height: 8),
            SizedBox(
              height: 280,
              child: SecureContentScope(
                enabled: _scopeEnabled,
                protectInAppSwitcher: true,
                appSwitcherColor: Colors.black,
                // iOS-only: center an asset-catalog image (white-tinted) on the
                // app-switcher / privacy overlay. Provide the name of an image
                // in the host app's Assets.xcassets to enable branding.
                // appSwitcherImageName: 'AppSwitcherLogo',
                policy: SecureContentPolicy(
                  requireBiometricOnResume: true,
                  inactivityTimeout: const Duration(seconds: 20),
                  enableIntegrityChecks: true,
                  hardBlockOnIntegrityRisk: _hardBlockMode,
                  enableRiskWatermark: true,
                  watermarkText: 'EXAMPLE SENSITIVE',
                ),
                onEvent: (event) {
                  if (!mounted) {
                    return;
                  }
                  setState(() {
                    _lastEvent = event.type.name;
                  });
                },
                overlayBuilder: (context) => BackdropFilter(
                  filter: ImageFilter.blur(sigmaX: 12, sigmaY: 12),
                  child: Container(color: Colors.black.withValues(alpha: 0.55)),
                ),
                lockScreenBuilder: _useCustomLockScreen
                    ? (context, onUnlock) =>
                          _buildCustomLockScreen(context, onUnlock)
                    : null,
                hardBlockBuilder: _useCustomHardBlock
                    ? (context) => _buildCustomHardBlockScreen(context)
                    : null,
                child: Card(
                  child: Center(
                    child: Text(
                      'Secure counter: $_counter',
                      style: Theme.of(context).textTheme.headlineMedium,
                    ),
                  ),
                ),
              ),
            ),
            const SizedBox(height: 12),
            Text('Last secure event: $_lastEvent'),
            const SizedBox(height: 4),
            const Text(
              'Tip: Android screenshot callback requires Android 14+.',
            ),
            const SizedBox(height: 12),
          ],
        ),
      ),
    ),
  );
}