reititfrontendeasy

reitit.frontend.easy is a frontend routing module in the Reitit library for ClojureScript that provides a compact, convenient API for building client-side routes in single-page applications. It offers a simple, data-driven DSL that lets developers declare routes as nested vectors with optional metadata, and integrates with the browser’s history or hash-based routing.

Routes in reitit.frontend.easy are defined using a concise data structure where each path segment is represented in a nested form. Leaf nodes can carry a map of options, including a route name and any default data. The module then exposes a router object created from that route specification, along with helpers to handle navigation and extraction of route parameters. A key feature is the ability to generate URL paths from a route name and parameter map, supporting link construction and programmatic navigation.

The API focuses on ease of use. Typical usage involves creating a router with a simple call, starting the router so that a navigation handler can respond to route matches, and using helpers to navigate or build paths. The library supports lifecycle hooks and interceptors for route transitions, allowing developers to run code on entry or exit from a route. It also provides a path-for function (or equivalent) to produce URLs for given routes, aiding in keeping links and redirects in sync with the route definitions.

reitit.frontend.easy is commonly used with ClojureScript UI toolkits such as Reagent or re-frame, where routing integrates with application state and view rendering. It is designed to minimize boilerplate while offering a robust, data-driven approach to client-side navigation, making it a popular choice for SPAs built with Reitit.