Skip to content
pubscout

activity_ring

0.3.0, released 5 years ago by an unverified publisher

Renders Apple Watch-style circular progress rings with customizable colors and gradients.

WASM-ready
$ flutter pub add activity_ring
Source repository

What it does

Provides a widget to display circular progress bars resembling Apple Watch activity rings. It supports multi-ring wrapping when progress exceeds 100%, allowing custom colors and gradients for each layer. It can also render child widgets in the center of the ring.

AI-written summary of version 0.3.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Building fitness or activity tracking interfaces that emulate Apple Watch rings.
  • Displaying progress that can exceed 100% and wrap into multiple overlapping concentric rings.

Skip it when

  • Needing non-circular progress indicators like linear bars.
  • Relying on auto-brightening colors with more than 3 rings, as it triggers a runtime exception.

Strengths

  • Supports multiple overlapping laps/rings when percent exceeds 100%.
  • Flexible color schemes supporting solid colors, single gradients, and distinct gradients per ring layer.
  • Easily nests custom child widgets inside the ring center.

Weaknesses

  • Known runtime exception if auto-brightening colors exceed 3 rings.
  • Lacks comprehensive automated tests and test coverage as noted in the roadmap.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
0
Ring(
  percent: 90,
  color: RingColorScheme(ringColor: Colors.red),
  radius: 80,
  width: 10,
  child: Center(child: Text('90%')),
)

Alternatives

Packages that do the same job and could replace activity_ring.

  • percent_indicator

    Offers broader options including standard circular and linear progress indicators with mature community support.