flutter_falling_items 1.1.1

A Flutter package for falling item animations like flowers, coins, etc.

To make the image appear statically (always visible in the README.md on GitHub), you can modify your README.md to embed the image directly. Here's how you can update your content to show the image at the top and make it more prominent:

Updated README.md with Static Image:

# 🌸 flutter_falling_items

A Flutter package for adding beautiful falling item animations like flowers, coins, icons, or images — creating a soft, raindrop-like visual experience 🌧️🌼

---

## 📸 Preview

![Preview Image](https://raw.githubusercontent.com/dhanushequinox/fallingitem/main/fallingitem/lib/assets/Screenshot_1745923899.png)

---

## ✨ Features

- 🌼 Animate any widget falling from top to bottom
- 📸 Supports images from assets or network
- 🎯 Customize count, size, and speed
- 🧩 Easy to plug into any Flutter app
- ⚙️ Built-in controller pooling for better performance

---

## 🚀 Getting Started

Add this package to your `pubspec.yaml`:

```yaml
dependencies:
  flutter_falling_items: ^0.2.0

Since you're working locally, keep publish_to: "none" if needed.

---

📦 Usage

✅ Basic Example

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

class MyFallingScreen extends StatefulWidget {
  @override
  State<MyFallingScreen> createState() => _MyFallingScreenState();
}

class _MyFallingScreenState extends State<MyFallingScreen>
    with TickerProviderStateMixin {
  final FlowerService _flowerService = FlowerService();
  final Map<ImageProvider, List<Widget>> _flowersMap = {};
  final Map<ImageProvider, List<AnimationController>> _controllersMap = {};

  late Size _screenSize;

  void _addFlowers(ImageProvider imageProvider) {
    _flowerService.addFlowersForImage(
      imageProvider: imageProvider,
      screenSize: _screenSize,
      vsync: this,
      flowersMap: _flowersMap,
      controllersMap: _controllersMap,
    );
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    _screenSize = MediaQuery.of(context).size;
    final flowerWidgets =
        _flowersMap.values.expand((widgets) => widgets).toList();

    return Scaffold(
      body: Stack(
        children: [
          Positioned.fill(
            child: Container(color: Colors.white),
          ),
          Center(
            child: ElevatedButton(
              onPressed: () {
                _addFlowers(
                  const NetworkImage(
                    'https://purepng.com/public/uploads/large/flower-2wq.png',
                  ),
                );
              },
              child: Text('Let it Rain Flowers!'),
            ),
          ),
          ...flowerWidgets,
        ],
      ),
    );
  }
}

---

🛠️ Customization

You can customize behavior inside addFlowersForImage():

Parameter	Type	Description
imageProvider	ImageProvider	Image to fall from top
screenSize	Size	Dimensions of the current screen
vsync	TickerProvider	Required for animations
flowersMap	Map	Internal map storing falling widgets
controllersMap	Map	Internal map storing animation controllers

---

💡 Tips

• Use compressed images for better memory efficiency
• Dispose controllers if you're not reusing them
• Combine multiple image types for varied animations

---

📄 License

This project is licensed under the MIT License.
See the full license here.

---

🔗 Links

• 🌐 GitHub Repository
• 🏠 Homepage