ar_captcha 1.0.0

Flutter plugin for integrating ARCaptcha, providing a secure and customizable captcha solution for mobile and web apps.

ar_captcha

A Flutter package to easily integrate ArCaptcha into your apps.
Supports multiple display modes (dialog, screen, modal bottom sheet) with a modern UI, loader, and full customization.

ArCaptcha is a privacy-friendly captcha solution designed to verify real users without intrusive challenges.

---

Features

• ✅ Show captcha in dialog, screen, or modal bottom sheet
• ✅ Built-in loader animation while captcha loads
• ✅ Works on Android, iOS, and Web
• ✅ Customizable height for captcha container
• ✅ Supports dark and light theme modes
• ✅ Easy success/error callbacks
• ✅ Secure HTML + JS integration with Flutter bridges

---

Installation

Add this to your pubspec.yaml:

dependencies:
  ar_captcha: ^1.0.0

Then run:

flutter pub get

Usage

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

class MyCaptchaScreen extends StatelessWidget {
  final ArCaptchaController _controller = ArCaptchaController(
    lang: 'en',
    siteKey: 'YOUR_SITE_KEY',
  );

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("Captcha Example")),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            _controller.showCaptcha(
              context: context,
              mode: CaptchaType.dialog,
              onSuccess: (token) {
                debugPrint("Captcha success: $token");
              },
              onError: (error) {
                debugPrint("Captcha failed: $error");
              },
            );
          },
          child: const Text("Show Captcha"),
        ),
      ),
    );
  }
}

API Reference

ArCaptchaController

Parameter	Type	Description	Default
siteKey	String	Your ArCaptcha site key (required).	–
lang	String	Language code for captcha.	en
domainUrl	String	Domain name of the app.	localhost
themeMode	ThemeMode	Theme mode (light/dark).	light
captchaHeight	double	Height of the captcha widget container.	550
onErrorMessage	String	Default error message if captcha fails.	"Something went wrong, try again!"
enableModalDrag	bool	Controls whether the modal can be dragged.	true
isModalDismissible	bool	Controls whether the modal can be dismissed.	true