StarRating - SwiftGit

SwiftUI

StarRating

August 2, 2025

This is a customizable star rating control written specifically for SwiftUI. It shows a star rating and handles user input. It also contains a star Shape with customizable number of vertices and weight.

Installation

Requirements iOS 13+

Swift Package Manager

In Xcode, open your project and navigate to File → Swift Packages → Add Package Dependency.
Paste the repository URL (https://github.com/dkk/StarRating) and click Next.
For Rules, select version.
Click Finish.

Swift Package


                                              
                                                .package(url: “https://github.com/dkk/StarRating”, .upToNextMajor(from: “1.2.0”))

Usage

Import StarRating package to your view.


                                              
                                                import StarRating

and you are ready to use StarRating or the Shape Star in you SwiftUI code.

Use StarRating to display a rating

You can display a rating with the line:


                                              
                                                // set the rating you want to display as initialRating

StarRating(initialRating: 3.7)

Use StarRating to get a rating from the user

To show a fully functional star rating that can handle user input, add the line:


                                              
                                                // set the initialRating

// add a callback to do something with the new rating

StarRating(initialRating: 0, onRatingChanged: { print($0) })

Configure StarRating

To configure the control, StarRating binds a StarRatingConfiguration object. This makes it easy to dynamically change the control’s style and behaviour.

Create a StarRatingConfiguration object:


                                              
                                                @State var customConfig = StarRatingConfiguration(minRating: 2, numberOfStars: 10)

Pass it when creating the instance of StarRating and update it later as needed:


                                              
                                                StarRating(initialRating: 2.0, configuration: $customConfig) { newRating in

customConfig.starVertices = Int(newRating)

}

Read the implementation of StarRatingConfiguration to see what configuration posibilities are available at the moment.

Use the Star Shape

Use Star the same way as you would use standard SwiftUI Shapes, such as Rectangle. Star allows to configure the number of vertices and the weight. Example usage:


                                              
                                                Star(vertices: 5, weight: 0.45)

GitHub

View Github

YOU MIGHT ALSO LIKE...

August 28, 2025
SwiftUI

MijickPopups Hero

Popups Alerts Resizable Sheets Banners

August 27, 2025
SwiftUI

SwiftUI Tooltip

This package provides you with an easy way to show tooltips over any SwiftUI view, since Apple does not provide ...

August 27, 2025
SwiftUI
Uncategorized

SimpleToast for SwiftUI

SimpleToast is a simple, lightweight, flexible and easy to use library to show toasts / popup notifications inside iOS or ...

August 27, 2025
SwiftUI

SSToastMessage

Create Toast Views with Minimal Effort in SwiftUI Using SSToastMessage. SSToastMessage enables you to effortlessly add toast notifications, alerts, and ...

August 27, 2025
SwiftUI

ToastUI

A simple way to show toast in SwiftUI Getting Started • Documentation • Change Log