lukepighetti/fluro

Fluro is a routing library for Flutter, which is a framework for building mobile and web apps using the Dart programming language. Routing in this context means managing which screen appears when a user navigates to a particular URL or path within the app. Flutter has a built-in routing system, and Fluro extends it with additional flexibility. The library lets developers define URL-like paths such as "/users/:id" where ":id" is a placeholder that gets filled in at runtime with an actual value. When the app navigates to "/users/1234", Fluro intercepts that path, extracts the value 1234, and sends it along to the appropriate screen. It also handles wildcard matching (paths that match a pattern rather than an exact string) and query string parsing (the key-value pairs that appear after a question mark in a URL). Beyond matching paths to screens, Fluro supports mapping paths to plain functions instead of screens, which is useful for side effects that do not require showing a new page. It also includes several built-in transition animations for moving between screens, such as fading in or sliding from the left, and supports defining custom transitions. For developers who prefer to pass structured data objects between screens rather than encoding everything in URL strings, Fluro supports that as well through a separate class-arguments mechanism. The library follows Flutter's stable release channel and includes null-safety support, which is a Dart language feature that helps prevent certain types of errors at compile time. Setup involves creating a router object, defining your routes and their handlers, and wiring the router into Flutter's standard navigation system.