flying_characters 0.0.2

A flutter package to animate flying characters or particles on screen.

---

🚀 Flying Characters

A lightweight Flutter package to create beautiful flying character animations (letters, emojis, particles, icons, etc.) floating across the screen. Perfect for celebratory effects, message animations, reactions, and playful UI moments.

---

🎬 GIF Previews

Fly	FadeBlur	Flip3D	SwirlFloat

---

✨ Features

• Animate characters, emojis, icons, or custom widgets
• Randomized movement for natural flying effect
• Configurable speed, size, duration & spread
• Multiple animation types: fly, fadeBlur, flip3d, swirlFloat
• Works on any widget using overlay or inside layout
• Lightweight & easy to integrate

---

📦 Installation

Add the package to your pubspec.yaml:

dependencies:
  flying_characters: ^0.0.2

Then run:

flutter pub get

---

📝 Example Usage

Basic Flying Text

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Flying Characters Demo')),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              FlyingCharacters.show(
                context,
                text: "🎉 Congratulations!",
                mode: FlyingCharactersMode.fly,
                duration: const Duration(seconds: 3),
              );
            },
            child: const Text("Celebrate!"),
          ),
        ),
      ),
    );
  }
}

Custom Widget Flying

FlyingCharacters.show(
  context,
  widget: Icon(Icons.star, size: 30, color: Colors.yellow),
  mode: FlyingCharactersMode.fly,
  duration: const Duration(seconds: 4),
);

---

⚙️ License

This package is licensed under the MIT License. See LICENSE for details.

---