liquid_swipe_onboarding #

A modern, fluid liquid wave onboarding carousel for Flutter with real-time finger wave distortion, spring physics, and animated morphing indicators.

✨ Features #

• 💧 Organic Liquid Wave Transitions: Touch-anchored cubic Bézier curves dynamically deform around your finger as you drag across the screen.
• 🚀 Impeller & 120Hz Ready: Smooth 60/120fps hardware-accelerated clipping path calculations with zero dropped frames.
• 💊 Morphing Pill Indicator: Built-in animated page indicator (LiquidPageIndicator) that morphs between dots and elongated active pills.
• 🎮 Programmatic Control: Navigate slides programmatically via LiquidSwipeController (nextPage(), previousPage(), animateToPage()).
• 🎨 Fully Customizable: Control skip buttons, get started actions, wave curves, and colors.
• 🧹 Zero External Dependencies: Pure Flutter SDK implementation.

🚀 Getting Started #

Add liquid_swipe_onboarding to your pubspec.yaml:

dependencies:
  liquid_swipe_onboarding: ^1.0.0

Import the package:

import 'package:liquid_swipe_onboarding/liquid_swipe_onboarding.dart';

💡 Quick Example #

final controller = LiquidSwipeController();

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: LiquidSwipeOnboarding(
      controller: controller,
      onCompleted: () => Navigator.pushReplacementNamed(context, '/home'),
      pages: [
        OnboardingSlide(
          color: Colors.indigo,
          title: 'Welcome to App',
          subtitle: 'Swipe horizontally to experience liquid wave transitions.',
        ),
        OnboardingSlide(
          color: Colors.teal,
          title: 'Fast & Fluid',
          subtitle: 'Designed specifically for modern mobile interfaces.',
        ),
        OnboardingSlide(
          color: Colors.pinkAccent,
          title: 'Ready to Explore',
          subtitle: 'Tap Get Started to begin your journey.',
        ),
      ],
    ),
  );
}

🛠️ Configuration Options #

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details. Copyright © 2026 Shahzain Baloch.