Animated Fav Button 💖 #

A Flutter package for creating animated favorite buttons with attractive visual effects like hearts, likes, and other reactions.

Features ✨ #

• 🎨 Smooth animations: Fluid transitions and attractive visual effects
• 🎯 Customizable: Fully configurable colors, icons, and effects
• 💫 Splash effects: Animated particles when the button is activated
• 🔧 Easy to use: Simple and intuitive API
• 📱 Responsive: Adapts to different screen sizes
• ⚡ Optimized performance: Efficient animations without performance impact

Installation 📦 #

Add animated_fav_button to your pubspec.yaml file:

dependencies:
  animated_fav_button: ^0.0.1

Then run:

flutter pub get

Basic Usage 🚀 #

import 'package:animated_fav_button/animated_react_button.dart';

AnimatedReactButton(
  reactColor: Colors.pink,
  defaultColor: Colors.grey,
  onPressed: () {
    // Your logic here
    print('Button pressed!');
  },
)

Complete Example 📝 #

import 'package:flutter/material.dart';
import 'package:animated_fav_button/animated_react_button.dart';

class MyFavoriteButton extends StatefulWidget {
  @override
  _MyFavoriteButtonState createState() => _MyFavoriteButtonState();
}

class _MyFavoriteButtonState extends State<MyFavoriteButton> {
  bool isFavorite = false;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Animated Fav Button Demo')),
      body: Center(
        child: AnimatedReactButton(
          isFavorite: isFavorite,
          reactColor: Colors.red,
          defaultColor: Colors.grey,
          iconSize: 40,
          showSplash: true,
          splashIcons: [Icons.favorite, Icons.star],
          splashColors: [Colors.red, Colors.pink, Colors.orange],
          onPressed: () {
            setState(() {
              isFavorite = !isFavorite;
            });
          },
        ),
      ),
    );
  }
}

Available Properties ⚙️ #

Advanced Customization 🎨 #

Different Icons #

AnimatedReactButton(
  defaultIcon: Icons.thumb_up,
  splashIcons: [Icons.thumb_up, Icons.star, Icons.favorite],
  reactColor: Colors.blue,
  // ... other properties
)

Custom Colors #

AnimatedReactButton(
  reactColor: Color(0xFF6C63FF),
  defaultColor: Color(0xFFE0E0E0),
  splashColors: [
    Color(0xFF6C63FF),
    Color(0xFF9C88FF),
    Color(0xFFD0C3FF),
  ],
  // ... other properties
)

Without Splash Effects #

AnimatedReactButton(
  showSplash: false,
  reactColor: Colors.green,
  // ... other properties
)

Use Cases 💡 #

• ✅ "Like" buttons in social media
• ✅ Favorites in e-commerce applications
• ✅ Reactions in chat applications
• ✅ Bookmarks in reading applications
• ✅ Content saving
• ✅ Any interaction requiring visual feedback

System Requirements 📋 #

• Flutter SDK: >=1.17.0
• Dart SDK: ^3.8.1

Contributing 🤝 #

Contributions are welcome! If you find a bug or have a suggestion:

1. Fork the project
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License 📄 #

This project is licensed under the MIT License. See the LICENSE file for more details.

Author 👨‍💻 #

GioRey - GitHub

Support 💬 #

If you have questions or need help:

• 📧 Open an issue on GitHub
• ⭐ Give the project a star if you found it useful
• 🐛 Report bugs to improve the package

Thanks for using Animated Fav Button! 🚀