zeba_academy_physics_ui

A powerful Flutter package providing beautiful physics-based UI interactions and animations.

License: GPL v3 Flutter Dart

✨ Features

✅ Spring animations
✅ Elastic dragging
✅ Snap effects
✅ Collision interactions
✅ Momentum scrolling
✅ Smooth physics behavior
✅ Lightweight and dependency-free
✅ Easy to integrate

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_physics_ui: ^1.0.0

Then run:

flutter pub get

🚀 Import

import 'package:zeba_academy_physics_ui/zeba_academy_physics_ui.dart';

📚 Widgets

Widget Description
SpringContainer Elastic spring tap animation
ElasticDrag Physics-based draggable widget
SnapWidget Snap-back interaction effect
CollisionWidget Boundary collision behavior
MomentumScroll Smooth momentum scrolling

🌟 SpringContainer

Provides spring tap animations.

SpringContainer(
  child: Container(
    width: 120,
    height: 120,
    color: Colors.blue,
  ),
)

🌟 ElasticDrag

Draggable widget with elastic return effect.

ElasticDrag(
  child: Container(
    width: 120,
    height: 120,
    color: Colors.green,
  ),
)

🌟 SnapWidget

Widget snaps back smoothly after drag.

SnapWidget(
  child: Container(
    width: 120,
    height: 120,
    color: Colors.orange,
  ),
)

🌟 CollisionWidget

Provides collision boundaries inside screen.

CollisionWidget(
  child: Container(
    width: 120,
    height: 120,
    color: Colors.red,
  ),
)

🌟 MomentumScroll

Smooth momentum scrolling experience.

MomentumScroll(
  children: [
    Container(height: 200, color: Colors.blue),
    Container(height: 200, color: Colors.green),
  ],
)

🧪 Testing

Run tests using:

flutter test

📂 Example

import 'package:flutter/material.dart';
import 'package:zeba_academy_physics_ui/zeba_academy_physics_ui.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('Physics UI Demo'),
        ),
        body: Center(
          child: SpringContainer(
            child: ElasticDrag(
              child: SnapWidget(
                child: CollisionWidget(
                  child: Container(
                    width: 120,
                    height: 120,
                    decoration: BoxDecoration(
                      color: Colors.blue,
                      borderRadius: BorderRadius.circular(20),
                    ),
                  ),
                ),
              ),
            ),
          ),
        ),
      ),
    );
  }
}

📸 Screenshots

Add your screenshots here.

example/screenshots/

🔥 Roadmap

  • Gravity physics
  • Magnetic snapping
  • Toss animations
  • Physics page transitions
  • Draggable card stacks
  • Interactive particles
  • Liquid swipe physics

🤝 Contributing

Contributions are welcome!

Feel free to open issues and pull requests.

📜 License

This project is licensed under the GNU General Public License v3.0.

See the LICENSE file for details.

👨‍💻 About Me

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

You can learn more about me and my work at sufyanism.com or connect with me on LinkedIn

🚀 Your all-in-one learning hub!

Explore courses and resources in coding, tech, and development at Zeba Academy.

💻 Practical tutorials
🚀 Real-world projects
🎯 Hands-on learning experience

🌐 Zeba Academy Links

➡ Main Website: https://zeba.academy
➡ Coding Platform: https://code.zeba.academy
➡ YouTube: https://www.youtube.com/@zeba.academy
➡ Instagram: https://www.instagram.com/zeba.academy/

❤️ Support

If you like this package, give it a ⭐ on GitHub and share it with the Flutter community.

🙌 Thank You

Thank you for visiting and supporting open-source development!

Libraries

zeba_academy_physics_ui