Avatar Rings

Custom user avatar widget, waves-like rings around, badges, status points, and many more customizations.

Preview

Installation 💻

❗ In order to start using Avatar Rings you must have the Flutter SDK installed on your machine.

Install via flutter pub add:

flutter pub add avatar_rings

Usage

AvatarRings(
  rings: 2, // The number of rings. Defaults to 1.
  radius: 70, // The radius of the entire rings painter. Defaults to 80.
  spaceBetweenRings: 1, // The space between each ring. Defaults to 1.
  fromPeriod: 250, // The start period value. Used to generate a random value starting from this value. Defaults to 150.
  toPeriod: 350, // The end period value. Used to generate a random value ending in this value. Defaults to 200.
  ringsColor: Colors.red, // The color of the rings. Defaults to [Colors.lightBlue].
  ringsColorOpacity: .3, // The opacity of the rings color. Defaults to 0.4.
  shadowColor: Colors.red, // The color of the shadow. Defaults to [Colors.lightBlue].
  shadowColorOpacity: .45, // The opacity of the shadow color. Defaults to 0.4.
  child: Image.asset(
    'assets/person.jpeg',
  ),
),

Continuous Integration 🤖

Avatar Rings comes with a built-in GitHub Actions workflow powered by Very Good Workflows but you can also add your preferred CI/CD solution.

Out of the box, on each pull request and push, the CI formats, lints, and tests the code. This ensures the code remains consistent and behaves correctly as you add functionality or make changes. The project uses Very Good Analysis for a strict set of analysis options used by our team. Code coverage is enforced using the Very Good Workflows.