3.7.1 (2026年06月10日)

Bug Fixes

• mount ScreenOptionsProvider in FloatOverlay (#125) (c2f0124)

3.7.0 (2026年06月06日)

Features

• add inactive screen lifecycle controls (#116) (2a92d22)
• add native-stack screen transitions adapter (#116) (2a92d22)
• add reveal background scale options (#116) (2a92d22)
• expose transition scopes to interpolators (#116) (2a92d22)

Bug Fixes

• avoid opacity visibility blocking (#116) (2a92d22)
• isolate adapter gesture options from native-stack options (#116) (2a92d22)
• preserve child gesture ownership while closing (#116) (2a92d22)
• proxy closing route gesture claims (#116) (2a92d22)
• reset missing transition style slots (#116) (2a92d22)

3.6.0 (2026年05月31日)

Features

• release v3.6.0 (#108) (fe9b902)

3.5.2 (2026年05月06日)

Bug Fixes

• replace removed absolute fill alias (#104) (007eb42)

3.5.1 (2026年05月05日)

Bug Fixes

• fix bounds worklet imports (#94) (6260b8f)

3.5.0 (2026年04月26日)

3.5.0-beta.0 (2026年04月21日)

Bug Fixes

• bounds: stabilize grouped zoom measurements (0ed8b82)
• deep linking bug fix (1464618)
• docs: include docs helpers and netlify config (#88) (403cff5)
• docs: ship docs as static netlify site (#89) (e91472a)
• group bounds retargetting bug (319d965)
• history: keep v3 close tracking on reanimated (7f6dcf8)
• isolate scroll axis writes in useScrollRegistry (#85) (88e6589)
• lifecycle: align close and history flow with next (f7f8ba7)
• previous screen not animating during flight (#74) (071512c)

Features

• docs: lift docs site onto main (#87) (935985c)

v3.4.0

v3.4 is a major step forward for react-native-screen-transitions.

This release sharpens the library around a clearer transition model: blank stack for advanced flows, layered interpolator output, explicit bounds ownership, real snap sheets, and stack-relative overlays.

Highlights

Blank stack is now the recommended path for advanced flows

createBlankStackNavigator() is now the default recommendation for custom transitions, snap sheets, overlays, bounds-driven motion, and embedded or independent flows.

createComponentStackNavigator() still exists, but new embedded work should prefer blank stack.

Snap points are now a first-class screen model

v3.4 adds a much stronger sheet/drawer surface:

• numeric detents and "auto" content-sized detents
• initialSnapIndex
• animated current.snapIndex
• current.layouts.content for measured content height
• sheetScrollGestureBehavior
• gestureSnapLocked
• gestureReleaseVelocityScale
• gestureReleaseVelocityMax

This makes it much easier to build real bottom sheets, drawers, and detented flows directly in the navigator model.

Bounds transitions and navigation zoom got a stronger API

v3.4 formalizes bounds-driven transitions around explicit boundary ownership:

• Transition.Boundary.Trigger
• Transition.Boundary.View
• Transition.Boundary.Target
• bounds({ id }).navigation.zoom()
• grouped and retargeted bounds flows
• navigationMaskEnabled for masked zoom reveals

For new bounds work, Transition.Boundary.* is now the preferred path.

Interpolators are now layer-based and screen-scoped

Interpolators now fit the actual screen container model more cleanly:

• return content, backdrop, and surface
• target individual elements with styleId
• read previous, current, next, active, and inactive
• prefer current.layouts and current.snapIndex
• use willAnimate and logicallySettled for better choreography

This gives custom animations a clearer and more composable surface.

Overlays are now a clearer stack-relative feature

Use overlay and overlayShown to define floating UI owned by a screen and carried upward through the rest of that stack.

This works with blank stack, native stack when transitions are enabled, and component stack.

Migration notes

For older setups moving onto 3.4:

• prefer Transition.Boundary.* over sharedBoundTag for new bounds flows
• replace flat interpolator keys with content, backdrop, and surface
• rename maskEnabled to navigationMaskEnabled
• rename expandViaScrollView to sheetScrollGestureBehavior
• move background / backgroundComponent naming to surface / surfaceComponent
• prefer blank stack over component stack for new embedded flows

Older aliases still exist in a few places for compatibility, but 3.4 establishes the current API direction.

Stability and polish

This cycle also included a large amount of stabilization work across bounds transitions, navigation zoom, masking, scroll handoff, gesture behavior, pointer-event handling, and release-candidate fixes.

Docs

The docs were rebuilt around the 3.4 model, with dedicated guides for migration, custom animations, snap points, overlays, bounds transitions, navigation zoom, stack types, and Expo Router.

Thanks to everyone who tested the alpha, beta, and rc builds and helped shape the API.

3.4.0-rc.1 (2026年04月12日)

Features

• type navigation mask slots (7e6f262)

3.4.0-rc.0 (2026年04月05日)