Flutter Fake Filler #

A Flutter package that automatically fills form fields with dummy data, inspired by the popular Fake Filler browser extension. Perfect for developers and testers working with forms during development.

Features #

• 🚀 Easy integration - just wrap your MaterialApp with FakeFiller widget
• 🎯 Smart field detection - automatically detects email, phone, date, and other field types
• 🎲 Realistic dummy data - generates appropriate data based on field context
• 🎨 Customizable - configure the floating action button appearance
• 🔧 Development-friendly - easily enable/disable in different environments
• ⚡ Zero configuration - works out of the box with sensible defaults

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_fake_filler: ^1.0.0

Then run:

flutter pub get

Usage #

Basic Setup #

Wrap your MaterialApp with the FakeFiller widget:

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return FakeFiller(
      enabled: true, // Set to false in production
      child: MaterialApp(
        title: 'My App',
        home: MyHomePage(),
      ),
    );
  }
}

Customization #

FakeFiller(
  enabled: kDebugMode, // Only enable in debug mode
  fabIcon: Icons.auto_fix_high,
  fabBackgroundColor: Colors.green,
  fabTooltip: 'Auto-fill forms',
  showSnackbar: true, // Show success/info messages (default: true)
  child: MaterialApp(
    // Your app here
  ),
)

Floating Action Button Positioning #

The package provides flexible positioning options for the floating action button:

Using Standard Flutter Locations

FakeFiller(
  enabled: true,
  fabBackgroundColor: Colors.deepPurple,
  fabLocation: FloatingActionButtonLocation.centerDocked,
  child: MaterialApp(
    // Your app here
  ),
)

Available standard locations:

• FloatingActionButtonLocation.endFloat (default)
• FloatingActionButtonLocation.centerFloat
• FloatingActionButtonLocation.startFloat
• FloatingActionButtonLocation.centerDocked
• FloatingActionButtonLocation.endDocked
• FloatingActionButtonLocation.startDocked

Using Custom Positioning

FakeFiller(
  enabled: true,
  fabBackgroundColor: Colors.teal,
  fabRightOffset: 20.0,  // Distance from right edge
  fabBottomOffset: 100.0, // Distance from bottom edge
  child: MaterialApp(
    // Your app here
  ),
)

Color and Appearance

FakeFiller(
  enabled: true,
  fabBackgroundColor: Colors.red,      // Custom background color
  fabIcon: Icons.auto_awesome,         // Custom icon
  fabTooltip: 'Fill all fields',      // Custom tooltip
  showSnackbar: false,                 // Disable snackbar notifications
  child: MaterialApp(
    // Your app here
  ),
)

Note: When you provide a custom fabBackgroundColor, the package automatically calculates the appropriate contrasting color for the icon to ensure good visibility.

Snackbar Notifications

By default, the package shows helpful snackbar messages when forms are filled or when no fields are found. You can disable these notifications:

FakeFiller(
  enabled: true,
  showSnackbar: false, // Silent mode - no snackbars shown
  child: MaterialApp(
    // Your app here
  ),
)

How it works #

1. The package adds a floating action button to your app
2. When tapped, it scans the current screen for text fields
3. It intelligently fills each field with appropriate dummy data based on:
   • Input type (email, tel, date, url, number)
   • Field name/label patterns
   • Context clues

Supported Field Types #

• Email: Generates realistic email addresses (e.g., [email protected])
• Phone: Creates formatted phone numbers (e.g., (555) 123-4567)
• Date: Provides random dates in YYYY-MM-DD format
• URL: Generates website URLs (e.g., https://www.example.com)
• Names: First names, last names, and full names
• Numbers: Random numerical values
• Text: Lorem ipsum style text content
• Multi-line Text: Intelligently generates content for bio, description, comment fields
• Length-constrained: Respects maxLength and maxLines properties of TextField

Advanced Features #

Max Length Support

The package automatically respects maxLength constraints on text fields:

TextField(
  maxLength: 50,
  decoration: InputDecoration(
    labelText: 'Short Description',
  ),
)

The generated content will be truncated to fit within the specified length, preferring to cut at word boundaries when possible.

Multi-line Support

For fields with maxLines > 1, the package generates appropriate multi-line content:

TextField(
  maxLines: 3,
  maxLength: 200,
  decoration: InputDecoration(
    labelText: 'Bio',
  ),
)

The content will be distributed across multiple lines while respecting both line and character limits.

Field Detection #

The package uses intelligent field detection based on:

1. TextInputType: TextInputType.emailAddress, TextInputType.phone, etc.
2. Field names: Keywords like "email", "phone", "name", "date" in labels/hints
3. Context patterns: Common form field naming conventions

Example #

class SignUpForm extends StatelessWidget {
  final _emailController = TextEditingController();
  final _phoneController = TextEditingController();
  final _nameController = TextEditingController();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Sign Up')),
      body: Padding(
        padding: EdgeInsets.all(16),
        child: Column(
          children: [
            TextField(
              controller: _nameController,
              decoration: InputDecoration(labelText: 'Full Name'),
            ),
            SizedBox(height: 16),
            TextField(
              controller: _emailController,
              keyboardType: TextInputType.emailAddress,
              decoration: InputDecoration(labelText: 'Email'),
            ),
            SizedBox(height: 16),
            TextField(
              controller: _phoneController,
              keyboardType: TextInputType.phone,
              decoration: InputDecoration(labelText: 'Phone Number'),
            ),
            SizedBox(height: 32),
            ElevatedButton(
              onPressed: () {
                // Handle form submission
              },
              child: Text('Sign Up'),
            ),
            // Tap the floating button to auto-fill all fields!
          ],
        ),
      ),
    );
  }
}

API Reference #

FakeFiller #

The main widget that wraps your app and provides the fake filling functionality.

Properties

DataGenerator #

Utility class for generating different types of dummy data.

Methods

• DataGenerator.email() - Generates email addresses
• DataGenerator.phoneNumber() - Generates phone numbers
• DataGenerator.fullName() - Generates full names
• DataGenerator.firstName() - Generates first names
• DataGenerator.lastName() - Generates last names
• DataGenerator.date() - Generates dates
• DataGenerator.website() - Generates website URLs
• DataGenerator.words(int count) - Generates lorem ipsum text

Best Practices #

1. Only enable in development: Use kDebugMode to automatically disable in release builds
2. Test with real data: Use fake filler for initial development, then test with realistic data
3. Clear fields before testing: The package only fills empty fields by default
4. Form validation: Ensure your form validation works with the generated dummy data

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 #

• Inspired by the Fake Filler browser extension
• Built with ❤️ for the Flutter community