Skip to content

Type Alias: SharedHeroMode ​

ts
type SharedHeroMode = "snapshot" | "morph" | "shuttle" | "zoom" | "auto";

Transition style for a shared-hero element.

  • "snapshot" (default): captures bitmaps of the source and destination views, translates and scales the flying clone on the window overlay, and cross-fades between the two snapshots.
  • "morph": Material container transform that interpolates bounds, corner radius (borderRadius), and background color while clipping the two snapshots inside the morphing container.
  • "shuttle": alias of "snapshot" in v1; reserved for a future native portal that renders a custom React subtree mid-flight.
  • "zoom": reserved for iOS 18+ system zoom transitions on a UINavigationController push; currently falls back to "morph".
  • "auto": uses "zoom" where natively supported, otherwise "morph".

Released under the MIT License.