# maxkonovalov/MKRingProgressView

⭕️ Ring progress view similar to Activity app on Apple Watch

Repository: https://github.com/maxkonovalov/MKRingProgressView
Canonical: https://ross.abutalabs.com/products/mkringprogressview
Language: Swift
License: MIT
License Family: permissive
Topics: ring, progress, progress-ring, progress-circle, progress-bar, progress-view, circle, gradient, conical-gradient, activity, apple, ios, swift
Last push: 2023-05-04T21:46:36+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3968, "days_push": 1217, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1571, forks 139 (observed 2026-08-28T04:05:05.442204+00:00)

## What it is
A Swift UI component library for iOS that renders circular ring progress views similar to the Activity app on Apple Watch. It supports animated progress, gradient colors, customizable ring width, and values above 100%.

## Use cases
- show a circular progress ring in an iOS app
- replicate Apple Watch Activity rings in my app
- display animated gradient progress circle
- show fitness goal completion as a ring
- customize ring width and end cap style for a progress indicator
- display progress values over 100% as overlapping rings

## When to choose
- building an iOS, tvOS, or watchOS app in Swift that needs ring-style progress indicators
- you want an Apple Watch Activity-style multi-ring display
- you need Interface Builder support and multiple package manager options

## When to avoid
- building for Android or cross-platform frameworks like Flutter or React Native
- you need linear or non-circular progress bars
- you need SwiftUI-native charts rather than a UIKit view

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, animation
- domain: mobile-development, frontend
- platform: -
- tags: progress-ring, swift-ui-component, gradient, apple-watch-activity, cocoapods, swift-package-manager, ios, swift, mobile

## Member repositories
- maxkonovalov/MKRingProgressView (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:05.442204+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:58:26.297482+00:00, confidence not recorded.
  - readme: https://github.com/maxkonovalov/MKRingProgressView (fetched 2026-08-28T04:05:05.442204+00:00, sha 953d38aa7189)
- Data as of 2026-08-30T08:39:29.467469+00:00.
