Custom Multi Search #

A customizable multi-select dropdown widget with search functionality for Flutter applications.
Built with MobX for reactive state management, smooth animations, and form validation support.

📖 Table of Contents #

• Features
• Preview
• Installation
• Usage
• Parameters
• Contributing
• License

✨ Features #

• 🔍 Searchable multi-select dropdown – quickly find and select items.
• 🎨 Customizable display – render items as text, icons, or custom widgets.
• ⚡ MobX-powered state management – ensures reactive and scalable behavior.
• 🪄 Smooth animations – professional and responsive UI interactions.
• 📱 Material Design styling – seamless Flutter integration.
• ✅ Form validation support – integrate directly into forms.

📸 Preview #

Example 1 #

[Multi search demo] [Multi search demo] [Multi search demo] [Multi search demo]

🚀 Installation #

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

dependencies:
  custom_multi_search: ^1.0.2

Then run:

flutter pub get

🛠 Usage #

import 'package:custom_multi_search/custom_multi_search.dart';

class ExamplePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: CustomMultiSearch<String>(
          items: ['Apple', 'Banana', 'Mango', 'Orange'],
          hintText: 'Select fruits',
          onChanged: (selectedItems) {
            print(selectedItems); // List of selected values
          },
          validator: (values) {
            if (values == null || values.isEmpty) {
              return 'Please select at least one item';
            }
            return null;
          },
        ),
      ),
    );
  }
}

⚙️ Parameters #

🤝 Contributing #

Contributions are welcome! 🎉

• Fork the repo
• Create a feature branch
• Submit a Pull Request

Feel free to open an issue for bugs or feature requests.

📜 License #

This project is licensed under the MIT License.

🙌 Acknowledgments #

• Flutter for the awesome framework.
• MobX for state management inspiration.