antigravity_motion 0.0.1

A premium Flutter package for weightless, floating, and spring-based motion effects. Perfect for creating immersive, gravity-defying UIs across Android, iOS, Web, and Desktop.

Antigravity Motion 🚀

Bring your Flutter UI to life with Antigravity Motion, a premium physics-based animation package that simulates weightlessness. Whether you want a slow, ethereal 'Space' effect or a bouncy, interactive 'Pulse', this package provides an effortless way to make your widgets defy gravity.

✨ Features

• Weightless Logic: Custom Cubic easing for extremely smooth, non-linear floating effects.
• Physics-Driven: Refined using SpringSimulation for realistic interactions.
• Interactive: Widgets react to touch—sinking slightly and springing back with realistic tension.
• Cross-Platform: Fully compatible with Android, iOS, Web, and Desktop.
• Performance: Built with performance-first practices for 60/120fps animations.

🚀 Getting Started

Add the package to your pubspec.yaml:

flutter pub add antigravity_motion

Or manually:

dependencies:
  antigravity_motion: ^0.0.1

🛠 Usage

Simply wrap any widget with AntigravityWrapper to give it weightless properties. Here is how you can make a FloatingActionButton float:

AntigravityWrapper(
  floatingRange: 15.0,
  duration: Duration(milliseconds: 2000),
  child: FloatingActionButton(
    onPressed: () {},
    child: Icon(Icons.rocket),
  ),
)

📋 Properties

Property	Type	Default	Description
child	Widget	Required	The widget to animate.
floatingRange	double	10.0	Peak vertical distance (pixels) the widget floats.
duration	Duration	2000ms	Duration for one full float cycle.
interactive	bool	true	Enables/disables the spring-physics interaction on tap.

🌟 License

This project is licensed under the MIT License - see the LICENSE file for details.