Latest 0.1.6
License MIT
Platforms ios 9.0

ProgressMeter 🎰

CI Status
Swift 4.0
Carthage compatible


Displaying the progress in a meter control. ProgressMeter lets you create your custom annotations that display either on top or bottom of meter. So, it’s not just an ordinary progress bar, it gives the better visual. 💯

Use Cases

Fitness App 🏃‍

Building a pedometer has never been easier. If you are looking for something other than a gauge control, you have come to the right place. Have a look 🤓


Banking App 🏦

Talking about financial apps. We all ‘ve come across with such scenarios to show the rewards earned or a cash back. ProgressMeter is here to help with a unique user experience. 🏧



Interface Builder

Guess what? You can do that all in design time without writing a single line of code.
Drag & drop a UIView from the object library and follow the steps:

Step 1:
Set the Class & Module Identity Inspector > Custom Class


Step 2:
Under Attribute Inspector you can change the properties and check everything on the fly 🚀

  • maxValue: Maximum value of the meter
  • progress: Current progress of meter
  • numberOfDivisions: How many divisions you want to display
  • Rest are pretty much self explanatory


Code 👨‍💻

Hook your view (ProgressMeter) property on your view controller and try out the snippets inside viewDidLoad;

Snippet # 1: Looking for setting up the control with your own data 👨‍🏫

func setupWithCustomData() {
    progressControl.maxValue = 20000 = [1999, 4999, 9999, 14999]
    progressControl.progress = 14999 / 20000

Snippet # 2: Don’t have the data set? ProgressMeter can create its own data 🔢

func setupWithControlData() {
    progressControl.maxValue = 20000
    progressControl.numberOfDivisions = 4
    progressControl.progress = 0.4

Snippet # 3: Setup the visual aspect 💄

func visualSetup() {
    progressControl.progressTintColor = .purple
    progressControl.trackTintColor = .gray
    progressControl.borderWidth = 1
    progressControl.borderColor = .darkGray
    progressControl.annotationTextColor = .purple
    progressControl.dividerColor = .darkGray



ProgressMeter is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod 'ProgressMeter'


To integrate ProgressMeter into your Xcode project using Carthage, specify the following in your Cartfile:

github "khawajafarooq/ProgressMeter"

Run carthage update to build the framework and drag the built ProgressMeter.framework into your Xcode project.


Support Version
iOS 9.0
Swift 4.0

Up Coming Features 🎏

  • [x] Carthage support
  • [x] Display Annotations either on top or bottom

Issues 🚫

  • [ ] Some tweakings required to use ProgressMeter inside a Stack View

Author 🙏🏻

Web: Khawaja Farooq

Twitter: @khfarooq

Medium: @khfarooq


ProgressMeter is available under the MIT license. See the LICENSE file for more info.

Latest podspec

    "name": "ProgressMeter",
    "version": "0.1.6",
    "summary": "Measuring the progress is not a problem anymore ud83dude0e",
    "description": "Displaying the progress in a meter control. `ProgressMeter` lets you create your custom annotations that display either on top or bottom of meter. So, it's not just an ordinary progress bar, it gives the better visual. ud83dudcafnDon't have data? No problem, ProgressMeter comes with it's own data set. ud83dudd22",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "khawajafarooq": "[email protected]"
    "source": {
        "git": "",
        "tag": "0.1.6"
    "social_media_url": "",
    "platforms": {
        "ios": "9.0"
    "source_files": "ProgressMeter/Classes/**/*.swift",
    "pushed_with_swift_version": "4.0"

Pin It on Pinterest

Share This