Six case studies measure Iris from the outside, through a demo app that fires URLs at it. This track goes the other way. Four short pieces open the library up and show the mechanisms that make race-safe, state-aware deep linking hold: how a URL becomes a typed intent, how a link to nothing is stopped, how sheet-versus-push is decided once, and how the resolved link reaches the one view that needs it.
The consumer case studies answer what Iris guarantees and prove it against a reference app. This internals track answers how, for anyone integrating the package or reading its source. Each piece takes one mechanism and follows it end to end, in the order a deep link travels: parsed at a single seam into a canonical intent, checked for existence at one gate, resolved to a sheet or a push in one place, then handed to the view that consumes it exactly once. The four read best in that order, and each stands alone.
A deep link enters the app as a string and leaves as a view on screen. Between those two points Iris does four things, each isolated so it can be reasoned about on its own. These articles take them in the order the link passes through them.
The internals
Reading an incoming deep link once, at a single seam, into a typed intent the rest of the app cannot misread.
Modelling does-the-target-exist as an optional caught at one gate, so a link to something missing stops cleanly instead of opening a broken screen.
Making the sheet-versus-push decision in a single place, so the same intent resolves to the same navigation from anywhere.
Carrying a resolved link to the one view that consumes it, delivered exactly once, with nothing left behind in global state.
The six consumer case studies measure these same mechanisms from the outside, through the demo app: race safety under bursts, the containment footprint, state-aware resolution, tap-and-URL parity, the control surface, and a primed draft from one URL. Start there for the guarantees; this track is the how behind them. Iris is open source and MIT licensed at github.com/async-digital-ltd/iris.