Search packages, repositories and app categories

simple_ripple_animation cover
Package detailsv0.1.1

simple_ripple_animation

This package provide ripple animation widget that is easy to set up and customise, and it looks beautiful in any color you choose.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
7.7K
Likes
153
Pub points
160

Install package

flutter pub add simple_ripple_animation

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that provides a simple, customizable ripple animation widget. It enables developers to easily add visually appealing ripple effects to buttons, taps, or any interactive element across multiple platforms. The animation is smooth and supports custom colors, sizes, and durations, making it ideal for enhancing user feedback in apps. With minimal setup, it integrates seamlessly into existing projects.

Use cases

  • Adding touch feedback to buttons
  • Enhancing UI interactions with visual effects
  • Creating animated backgrounds
  • Improving user engagement in mobile apps
  • Designing interactive elements on web
  • Customizing ripple appearance for branding

Key features

  • Easy setup with minimal code
  • Supports custom colors and sizes
  • Smooth, performant animations
  • Cross-platform compatibility
  • Configurable ripple duration and intensity
  • Simple API for customization

Suitable for

  • UI/UX designers seeking visual polish
  • Developers building interactive apps
  • Projects requiring subtle touch feedback
  • Apps targeting multiple platforms
  • Teams wanting fast implementation of animations
  • Creative interfaces with dynamic feedback

Considerations

  • May impact performance if overused
  • Limited advanced animation controls
  • Best suited for small-scale ripple effects
  • Not ideal for complex motion design
  • Requires careful color selection for visibility
  • Depends on platform-specific rendering behaviors

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Simple Ripple Animation

style: very good analysis License: MIT

This package provide ripple animation widget that can be customised to meet your needs. It's easy to set up and customize, and it looks beautiful in any color you choose.

Features

This package support following parameter and methods.

Parameter

RippleAnimationwidget provide follwoing parameter to config your ripple animation effect.

Parameter defined for RippleAnimation widget:

Name Type Description
child Widget This child will be placed at center of the animation.
delay Duration This will be delay between two ripple wave.
minRadius double Minimum radius of the ripple wave.
maxRadius double Maximum radius of the ripple wave.
color Color Color of the animation.
ripplesCount int number of rippleCount in the wave.
duration Duration duration of the animation
repeat bool Provide true if you want to repeat animation

Getting started

Installing

  1. Add dependencies to pubspec.yaml

    Get the latest version in the 'Installing' tab on pub.dev

    dependencies:
        simple_ripple_animation: <latest-version>
    
  2. Run pub get.

    flutter pub get
    
  3. Import package.

    import 'package:simple_ripple_animation/simple_ripple_animation.dart';
    

Implementation

  1. Wrap Widget with RippleAnimation and assign needed parameter.

             RippleAnimation(
                child: CircleAvatar(
                  minRadius: 75,
                  maxRadius: 75,
                  backgroundImage: NetworkImage(Constants.avtarUrl),
                ),
                color: Colors.deepOrange,
                delay: const Duration(milliseconds: 300),
                repeat: true,
                minRadius: 75,
                maxRadius: 140,
                ripplesCount: 6,
                duration: const Duration(milliseconds: 6 * 300),
              )
    

Preview

Screenshot

TODO: Here is the few screenshot for the preview. This will be remove in new verison becuase pub.dev now support screenshot.


Mobile

Tablet

Desktop

Web

Main Contributors


Jemis Goti

Furkan Arslan

Thanks

Thank you for using this package and keep supporting opensource community.

Categories

Source repository

Projects using this package

No data available yet.