Swiftpack.co - frzi/SwiftUIRouter as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by frzi.
frzi/SwiftUIRouter 1.3.2
Path-based routing in SwiftUI
⭐️ 594
🕓 17 weeks ago
iOS macOS watchOS tvOS
.package(url: "https://github.com/frzi/SwiftUIRouter.git", from: "1.3.2")
SwiftUI Router

Easy and maintainable app navigation with path-based routing for SwiftUI.

SwiftUI SwiftUI Swift Xcode MIT

With SwiftUI Router you can power your SwiftUI app with path-based routing. By utilizing a path-based system, navigation in your app becomes more flexible and easier to maintain.

:warning: During WWDC22 Apple introduced NavigationStack to SwiftUI. This provides a similar workflow to SwiftUI Router as well as being type-safe. There are however some key differences. It is recommended to try out NavigationStack before using SwiftUI Router in your project.


Installation 🛠

In Xcode add the dependency to your project via File > Add Packages > Search or Enter Package URL and use the following url:


Once added, import the package in your code:

import SwiftUIRouter

Bada bing bada boom you're ready to go.

Documentation 📚

Examples 👀

Usage 🚀

Below a quick rundown of the available views and objects and their basic features. For further details, please check out the documentation in the Swift files.


Router {

The entry of a routing environment. Wrap your entire app (or just the part that needs routing) inside a Router. This view will initialize all necessary environment values needed for routes.


Route("news/*") {
Route("settings") {
Route("user/:id?") { info in
	UserScreen(id: info.parameters["id"])

A view that will only render its contents if its path matches that of the environment. Use /* to also match deeper paths. E.g.: the path news/* will match the following environment paths: /news, /news/latest, /news/article/1 etc.


Paths can contain parameters (aka placeholders) that can be read individually. A parameter's name is prefixed with a colon (:). Additionally, a parameter can be considered optional by suffixing it with a question mark (?). The parameters are passed down as a [String : String] in an RouteInformation object to a Route's contents.
Note: Parameters may only exist of alphanumeric characters (A-Z, a-z and 0-9) and must start with a letter.

Parameter validation

func validateUserID(routeInfo: RouteInformation) -> UUID? {
	UUID(routeInfo.parameters["id"] ?? "")

Route("user/:id", validator: validateUserID) { userID in
	UserScreen(userID: userID)

A Route provides an extra step for validating parameters in a path.

Let's say your Route has the path /user/:id. By default, the :id parameter can be anything. But in this case you only want valid UUIDs. Using a Route's validator argument, you're given a chance to validate (and transform) the parameter's value.

A validator is a simple function that's passed a RouteInformation object (containing the parameters) and returns the transformed value as an optional. The new transformed value is passed down to your view instead of the default RouteInformation object. If the transformed value is nil the Route will prevent rendering its contents.


NavLink(to: "/news/latest") {
	Text("Latest news")

A wrapper around a Button that will navigate to the given path if pressed.


SwitchRoutes {
	Route("latest") {
	Route("article/:id") { info in
		NewsArticleScreen(articleID: info.parameters["id"]!)
	Route(":unknown") {
	Route {

A view that will only render the first Route whose path matches the environment path. This is useful if you wish to work with fallbacks. This view can give a slight performance boost as it prevents Routes from path matching once a previous Route's path is already resolved.


Navigate(to: "/error-404")

This view will automatically navigate to another path once rendered. One may consider using this view in a fallback Route inside a SwitchRoutes.


@EnvironmentObject var navigator: Navigator

An environment object containg the data of the Router. With this object you can programmatically navigate to another path, go back in the history stack or go forward.


@EnvironmentObject var routeInformation: RouteInformation

A lightweight object containing information of the current Route. A RouteInformation contains the current path and a [String : String] with all the parsed parameters.

This object is passed down by default in a Route to its contents. It's also accessible as an environment object.

License 📄

MIT License.


Stars: 594
Last commit: 3 weeks ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

17 weeks ago
  • Added currentStackIndex to Navigator (pull request #56)

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics