Latest 0.5.1
License MIT
Platforms ios 8.0
Frameworks UIKit

CI Status


To run the example project, clone the repo, and run pod install from the Example directory first.


To use JKSteppedProgressBar Xcode 8.0 or later is required


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

pod 'JKSteppedProgressBar'

JKSteppedProgressBar can be added and configured directly from storyboard.

How to Add Stepped Progress Bar

  • Add a blank UIView and set constraints
  • Set the Class & Module from identity inspector
  • Set the active & inactive color from Attributes inspector

setting custom title

  • Use the IBOutlet instance to set properties
  • Set your title array to titles property
    progressbar.titles = ["Step 1", "Step 2", "Step 3"]

    setting custom title and images

  • Use the IBOutlet instance to set properties
  • Set your title array to titles property
  • Set your images array to images property
    progressbar.titles = ["Step 1", "Step 2", "Step 3"]
    progressbar.images = [
    UIImage(named: "DaisyDuck")!,
    UIImage(named: "MickeyMouse")!,
    UIImage(named: "MinnieMouse")!,

    setting custom color for the progress

  • after setting your titles or images, set the property activeStepColors
    progressbar.activeStepColors = [,,,
  • this will change the color whenever you are at that step. For example, when you are at step 1, it will be red. And in second step, the whole progress bar will become orange and when you are at the last step, it will be green. So that the user will get a feeling of accomplishment through the steps.
  • setting custom active-images

  • this will make it possible to use this as progress for forms
  • Set your images to activeImages property
  • Set your tintActiveImage to tint the images to the active color (default: false)
  • Set your justCheckCompleted to select everything behind the current step but keep the current step highlighted (default: true)
  progressbar.activeImages = [
      UIImage(named: "check")!,
      UIImage(named: "check")!,
      UIImage(named: "check")!,
  progressbar.tintActiveImage = true
  progressbar.justCheckCompleted = false


Demo Video


  • [x] Add image for steps
  • [x] Respect language direction for drawing



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

Latest podspec

    "name": "JKSteppedProgressBar",
    "version": "0.5.1",
    "summary": "JKSteppedProgressBar is an iOS UI component that indicates step by step progress",
    "description": "JKSteppedProgressBar is an iOS UI component written in Swift to show step by step progress",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Johnykutty Mathew": "[email protected]"
    "source": {
        "git": "",
        "tag": "0.5.1"
    "platforms": {
        "ios": "8.0"
    "source_files": "JKSteppedProgressBar/Classes/*.swift",
    "frameworks": "UIKit"

Pin It on Pinterest

Share This