zeba_academy_animation_gallery 1.0.0

zeba_academy_animation_gallery: ^1.0.0 copied to clipboard

📄 ZEBA ACADEMY ANIMATION GALLERY 📦 Flutter Package Documentation (Production Ready) 👤 About Author

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

🌐 Website: https://sufyanism.com 💼 LinkedIn: https://www.linkedin.com/in/sufyanism

🎯 Project Overview

Zeba Academy Animation Gallery is a Flutter package designed to showcase and manage animations in a structured, reusable way.

It provides a complete system for:

🎞 Animation examples gallery 🔁 Page transitions ❤️ Hero animations 🎮 Play / Pause controls ⚡ Speed adjustment 👀 Live preview mode 🚀 Key Features 🎨 Animation System Custom animation builder support Frame-based animation preview Reusable animation items 📚 Gallery System Scrollable animation list Click-to-preview design Modular item structure 🎮 Controls Play / Pause animation Speed adjustment (0.5x → 3.0x) Real-time updates 🔁 Transitions Fade transitions Custom PageRouteBuilder support ❤️ Hero Animations Seamless shared element transitions Easy tag-based setup 👀 Preview Mode Live animation rendering Interactive control panel 📦 Installation Step 1 — Add dependency dependencies: zeba_academy_animation_gallery: ^1.0.0 Step 2 — Install package flutter pub get 🧠 Basic Usage 📌 Create Animation Gallery import 'package:flutter/material.dart'; import 'package:zeba_academy_animation_gallery/zeba_academy_animation_gallery.dart';

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

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

@override Widget build(BuildContext context) { return MaterialApp( home: AnimationGalleryPage( items: [ AnimationItem( title: "Fade Animation", description: "Simple opacity animation", builder: (context, value) { return Opacity( opacity: value, child: const FlutterLogo(size: 120), ); }, ), ], ), ); } } 🎞 AnimationItem Structure 📌 Definition AnimationItem( title: "Slide Animation", description: "Moves widget horizontally", builder: (context, value) { return Transform.translate( offset: Offset(100 * (1 - value), 0), child: const FlutterLogo(size: 120), ); }, ); 👀 Preview Mode Features: ▶️ Play / Pause toggle ⚡ Speed control slider 🔄 Loop animation 🎯 Real-time rendering ❤️ Hero Animation Example Hero( tag: "hero-box", child: Container( width: 120, height: 120, color: Colors.blue, ), ); 🔁 Page Transition Example Navigator.push( context, PageRouteBuilder( pageBuilder: (_, __, __) => const NextPage(), transitionsBuilder: (, animation, __, child) { return FadeTransition( opacity: animation, child: child, ); }, ), ); ⚙️ Controller System Features: 🎮 Play / Pause toggle ⚡ Speed adjustment 🔔 State notifier support 📁 Package Structure lib/ ┣ src/ ┃ ┣ models/ ┃ ┣ controllers/ ┃ ┣ pages/ ┃ ┣ widgets/ ┣ zeba_academy_animation_gallery.dart 🧪 Testing

Run tests using:

flutter test 📄 License 🟢 GNU GENERAL PUBLIC LICENSE (GPL-3.0)

This project is licensed under GPL-3.0.

You are free to:

✔ Use ✔ Modify ✔ Distribute

But:

❗ Any distributed version must remain open-source under GPL

🔗 Full license: https://www.gnu.org/licenses/gpl-3.0.en.html

🌍 Zeba Academy Ecosystem

🚀 Learn and explore:

https://zeba.academy https://code.zeba.academy https://www.youtube.com/@zeba.academy https://www.instagram.com/zeba.academy/ 💙 Final Note

This package is designed to be:

Clean Reusable Developer-friendly Production-ready ⭐ Support

If you like this package:

⭐ Star the repo 🔁 Share with developers 🚀 Use in your Flutter projects