zeba_academy_gesture_engine

🚀 Advanced custom gesture recognition engine for Flutter.

A powerful, lightweight, and extensible gesture engine that allows developers to create and recognize custom gestures like lines, circles, Z-shapes, and combinations — all without heavy dependencies.

✨ Features

  • 🎯 Custom gesture recognition (Line, Circle, Z-shape)
  • 🔄 Gesture combinations support
  • ⚡ Velocity tracking
  • 🧭 Direction analysis
  • 🧼 Gesture smoothing (noise reduction)
  • 🧩 Easy-to-use widget API
  • 🚀 Lightweight & no external dependencies

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_gesture_engine: ^0.1.0

Then run:

flutter pub get

🚀 Usage

Basic Example

import 'package:zeba_academy_gesture_engine/zeba_academy_gesture_engine.dart';

GestureWidget(
  onGesture: (type, velocity) {
    print("Gesture: $type | Velocity: $velocity");

    if (type == GestureType.circle) {
      print("Circle detected");
    }
  },
  child: Container(
    color: Colors.white,
    child: const Center(
      child: Text("Draw a gesture"),
    ),
  ),
)

🎮 Gesture Types

  • GestureType.line
  • GestureType.circle
  • GestureType.zShape
  • GestureType.unknown

🔥 Advanced Usage

Gesture Combination Detection

// Example: Z → Circle combo

if (type == GestureType.circle) {
  Navigator.pushNamed(context, '/home');
}

🧠 How It Works

The engine processes touch input into gesture points and performs:

  • Distance calculations
  • Direction tracking using atan2
  • Velocity computation
  • Shape matching using geometric heuristics

📁 Project Structure

lib/
 ├── gesture_engine.dart
 └── src/
     ├── gesture_point.dart
     ├── gesture_analyzer.dart
     ├── gesture_matcher.dart
     ├── gesture_controller.dart
     ├── gesture_widget.dart
     └── gesture_types.dart

🧪 Testing

Run tests using:

flutter test

📌 Roadmap

  • ✨ $1 Gesture Recognizer implementation
  • ✨ Multi-touch gesture support
  • ✨ Gesture templates system
  • ✨ Visual gesture debugger
  • ✨ Bezier curve smoothing

📜 License

This project is licensed under the GNU General Public License (GPL).

👨‍💻 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 no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development. ➡ Visit our main site: zeba.academy ➡ Explore hands-on courses and resources at: code.zeba.academy ➡ Check out our YouTube for more tutorials: zeba.academy ➡ Follow us on Instagram: zeba.academy

🙌 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

⭐ Support

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

Thank you for visiting! 🚀

Libraries

zeba_academy_gesture_engine