🚀 zeba_academy_scroll_physics_lab

A powerful Flutter package for custom scroll physics, fine-tuned motion control, and interactive physics editing.

Design fluid, natural, and highly customizable scrolling experiences across all platforms.

✨ Features

  • 🎯 Custom Scroll Physics Engine
  • ⚙️ Bounce & Friction Tuning
  • 🔄 Multi-Device Scroll Support (Touch, Mouse, Stylus, Trackpad)
  • 🧪 Real-time Physics Editor UI
  • 🚀 High-performance & lightweight
  • 📦 Clean architecture & extensible design

📦 Installation

Add the dependency to your pubspec.yaml:

dependencies:
  zeba_academy_scroll_physics_lab: ^0.0.1

Then run:

flutter pub get

🚀 Usage

1. Import

import 'package:zeba_academy_scroll_physics_lab/zeba_academy_scroll_physics_lab.dart';

2. Basic Example

final controller = PhysicsController();

ListView.builder(
  physics: CustomScrollPhysics(config: controller.config),
  itemCount: 50,
  itemBuilder: (_, i) => ListTile(title: Text('Item $i')),
);

3. Enable Multi-Direction Scroll

MaterialApp(
  scrollBehavior: MultiDirectionScrollBehavior(),
  home: MyHomePage(),
);

4. Add Physics Editor (Live Tuning)

PhysicsEditor(controller: controller);

⚙️ Configuration

Customize physics using PhysicsConfig:

PhysicsConfig(
  friction: 0.02,
  bounceFactor: 0.6,
  minFlingVelocity: 50,
  maxFlingVelocity: 8000,
);

🧠 Architecture

Layer Responsibility
Models PhysicsConfig
Core Custom physics engine
Controller State management
Widgets Physics editor UI
Behavior Multi-device scrolling

🧪 Testing

Run tests:

flutter test

All core physics behaviors and controllers are fully tested.

📌 Use Cases

  • 🎮 Game-like scroll experiences
  • 📱 Advanced UI/UX animations
  • 📊 Scroll tuning tools
  • 🧪 Physics experimentation

🛣️ Roadmap

  • ✅ Physics presets (iOS, Android, Gaming)
  • 🔄 Free-axis scrolling (2D scroll)
  • 📊 Debug overlay (velocity, friction graphs)
  • ⚡ Performance benchmarks

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a new branch
  3. Commit your changes
  4. Open a pull request

📄 License (GPL v3)

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

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 https://sufyanism.com/ or connect with me on https://www.linkedin.com/in/sufyanism

Your all-in-one no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy.

Zeba Academy is a learning platform dedicated to coding, technology, and development.

➡ Visit: https://zeba.academy ➡ Learn: https://code.zeba.academy ➡ YouTube: https://www.youtube.com/@zeba.academy ➡ Instagram: https://www.instagram.com/zeba.academy/

Thank you for visiting! 🙌

Libraries

zeba_academy_scroll_physics_lab