smart_form_guard #

Forms that guide users instead of punishing them.

A smart Flutter form wrapper that validates fields, auto-focuses & scrolls to the first invalid field, and provides pleasant visual feedback with shake animations and soft glow effects.

📸 Screenshots #

✨ Features #

• 🎯 Auto-focus first invalid field on submit
• 📜 Auto-scroll to off-screen errors
• 🌊 Shake animation for invalid fields
• ✨ Soft glow effect on errors
• 🔄 Progressive validation (one error at a time)
• 📦 Zero configuration for common use cases
• 🎨 Customizable styling and behavior

📦 Installation #

Add to your pubspec.yaml:

dependencies:
  smart_form_guard: ^0.1.0

Then run:

flutter pub get

🚀 Quick Start #

import 'package:smart_form_guard/smart_form_guard.dart';

SmartForm(
  onValid: () => print("Form is valid 🎉"),
  child: Column(
    children: [
      SmartField.email(
        controller: emailCtrl,
        label: "Email",
      ),
      SmartField.password(
        controller: passCtrl,
        label: "Password",
      ),
      SmartSubmitButton(
        text: "Create account",
      ),
    ],
  ),
);

📖 API Reference #

SmartForm #

The main wrapper for your form fields.

SmartField #

Input field with built-in validation and animations.

Factory Constructors

Common Properties

SmartSubmitButton #

Triggers form validation on press.

SmartValidators #

Utility class with common validators.

// Compose multiple validators
SmartValidators.compose([
  SmartValidators.required('Field is required'),
  SmartValidators.email('Invalid email'),
]);

// Available validators
SmartValidators.required()
SmartValidators.email()
SmartValidators.password(minLength: 8, requireUppercase: true)
SmartValidators.phone()
SmartValidators.minLength(5)
SmartValidators.maxLength(100)
SmartValidators.pattern(RegExp(r'...'))

🎨 Customization #

Custom Field #

SmartField(
  controller: controller,
  label: 'Custom Field',
  validator: SmartValidators.compose([
    SmartValidators.required(),
    SmartValidators.minLength(3),
  ]),
  prefixIcon: Icons.star,
  decoration: InputDecoration(...),
)

Custom Submit Button #

SmartSubmitButton(
  text: 'Submit',
  backgroundColor: Colors.indigo,
  textColor: Colors.white,
  borderRadius: 16,
  icon: Icons.send,
)

🗺️ Roadmap #

• ❌ Additional field types (date, dropdown, checkbox)
• ❌ Haptic feedback option
• ❌ Form state persistence
• ❌ Custom animation options
• ❌ Real-time validation mode

🧪 Testing #

flutter test

📄 License #

MIT License - see LICENSE for details.

Made with ❤️ for the Flutter community