feat (Android): setTransitionDuration on Android by FilPag · Pull Request #3698 · software-mansion/react-native-screens

FilPag · 2026-02-26T14:35:38Z

Description

On iOS, native-stack supports the animationDuration prop, allowing us to make transitions faster. However, on Android, this prop is ignored because the animations are hardcoded in native XML files within react-native-screens. This makes the App feel "laggy" or "unnecessarily heavy" compared to the iOS version or other high-performance native Android apps.

This PR exposes a property to control the transition duration for Android, allowing developers to set a shorter duration (e.g., 200ms instead of the default) to achieve a "snappier" feel.

Changes

Implemented transitionDuration prop on Android by wiring ScreenViewManager to Screen.kt and overriding onCreateAnimation in ScreenStackFragment to apply the custom duration
Changed sentinel default from 500 to -1 (unset) across Codegen specs and Paper delegate
Added duration picker to the Animations example screen
Updated public types to reflect Android support for transitionDuration

Before & after - visual documentation

Screen.Recording.2026-02-26.at.15.26.07.mov

Test plan

Added duration picker to the Animations example screen. Navigate to Animations example screen in FabricExample. Test the duration selector

Checklist

Included code example that can be used to test this change.
Updated / created local changelog entries in relevant test files.
For visual changes, included screenshots / GIFs / recordings documenting the change.
For API changes, updated relevant public types.
Ensured that CI passes

FilPag · 2026-03-06T10:29:55Z

@kkafar Could you please request reviewers on my behalf. I'm unable to do so :)

kkafar · 2026-03-07T09:10:06Z

Thanks for the tag here.

Copilot

Pull request overview

Adds Android support for configuring native-stack transition duration by plumbing the transitionDuration prop into the Android screen implementation and providing an example UI to tweak durations at runtime.

Changes:

Switches the transitionDuration sentinel default to -1 (unset) in Fabric codegen specs and the Paper delegate.
Wires transitionDuration through ScreenViewManager → Screen and applies it during fragment animation creation.
Extends the Animations example screen with a transition duration picker (via React Navigation animationDuration).

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/fabric/ScreenNativeComponent.ts	Updates codegen default for `transitionDuration` to `-1` (unset).
src/fabric/ModalScreenNativeComponent.ts	Updates codegen default for `transitionDuration` to `-1` (unset).
apps/src/screens/Animations.tsx	Adds UI controls to vary transition duration in the example app.
android/src/paper/java/com/facebook/react/viewmanagers/RNSScreenManagerDelegate.java	Updates Paper delegate default for `transitionDuration` to `-1`.
android/src/main/java/com/swmansion/rnscreens/ScreenViewManager.kt	Implements `transitionDuration` prop setter for Android screens.
android/src/main/java/com/swmansion/rnscreens/ScreenStackFragment.kt	Overrides `onCreateAnimation` to apply custom duration when set.
android/src/main/java/com/swmansion/rnscreens/Screen.kt	Adds `transitionDuration` field to the Android `Screen` view.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

# Conflicts: # android/src/main/java/com/swmansion/rnscreens/ScreenViewManager.kt # android/src/paper/java/com/facebook/react/viewmanagers/RNSScreenManagerDelegate.java

kmichalikk

Hi @FilPag
Thanks for the PR. I left some comments, please answer them.

kmichalikk · 2026-05-07T15:17:19Z

    var stackPresentation = StackPresentation.PUSH
    var replaceAnimation = ReplaceAnimation.POP
    var stackAnimation = StackAnimation.DEFAULT
+    var transitionDuration: Int = -1


nit: Let's document here what does -1 mean or introduce some constant & use it later. If you go for a constant, you might want to make sure that -1 is the only valid negative integer (in the setter, for instance).

kmichalikk · 2026-05-07T15:22:56Z

+                val scale = targetDuration.toDouble() / naturalDuration.toDouble()
+                for (child in animation.animations) {
+                    child.startOffset = (child.startOffset * scale).toLong()
+                    scaleAnimationDuration(child, (child.duration * scale).toLong())


I think we only have one-level deep nesting in our animations, but still, computeDurationHint for child would be better

kmichalikk · 2026-05-07T15:26:08Z

  stackPresentation?: CT.WithDefault<StackPresentation, 'push'>;
  stackAnimation?: CT.WithDefault<StackAnimation, 'default'>;
-  transitionDuration?: CT.WithDefault<CT.Int32, 500>;
+  transitionDuration?: CT.WithDefault<CT.Int32, -1>;


You never updated iOS side after this change. It works only because there is a fallback to 500 for duration < 0, but this is not documented anywhere.

There is outdated comment above static constexpr NSTimeInterval RNSDefaultTransitionDuration = 0.5; that you should change.

Additionally, I'd set the above default as soon as possible to not store the negative value anywhere since it's not a valid value in the iOS flow.

kmichalikk · 2026-05-07T15:27:10Z

  stackPresentation?: CT.WithDefault<StackPresentation, 'push'>;
  stackAnimation?: CT.WithDefault<StackAnimation, 'default'>;
-  transitionDuration?: CT.WithDefault<CT.Int32, 500>;
+  transitionDuration?: CT.WithDefault<CT.Int32, -1>;


Same as above

FilPag · 2026-05-08T10:05:37Z

@kmichalikk Thank you for the comments. did some updates. let me know what you think!

feat: setTransitionDuration on Android

0cd382a

FilPag changed the title ~~feat: setTransitionDuration on Android~~ feat (Android): setTransitionDuration on Android Feb 26, 2026

kkafar requested review from Copilot, kkafar and kmichalikk March 7, 2026 09:10

Copilot started reviewing on behalf of kkafar March 7, 2026 09:10 View session

Copilot AI reviewed Mar 7, 2026

View reviewed changes

Comment thread android/src/main/java/com/swmansion/rnscreens/ScreenStackFragment.kt Outdated

Comment thread android/src/main/java/com/swmansion/rnscreens/ScreenViewManager.kt Outdated

Comment thread src/fabric/ScreenNativeComponent.ts Outdated

adressed comments

80a52b7

FilPag requested a review from Copilot March 9, 2026 12:35

Copilot started reviewing on behalf of FilPag March 9, 2026 12:35 View session

Copilot AI reviewed Mar 9, 2026

View reviewed changes

Comment thread src/types.tsx

FilPag added 2 commits March 9, 2026 13:54

docs: updated Android note

14dac66

Merge remote-tracking branch 'upstream/main'

864d186

# Conflicts: # android/src/main/java/com/swmansion/rnscreens/ScreenViewManager.kt # android/src/paper/java/com/facebook/react/viewmanagers/RNSScreenManagerDelegate.java

kmichalikk requested changes May 7, 2026

View reviewed changes

FilPag added 2 commits May 8, 2026 11:18

fix: ios - normalize unsetr transitionDuration at prop boundary

20d8f57

fix: android - name and validate transitionDuration unset sentinel value

09667c3

FilPag requested a review from kmichalikk May 8, 2026 10:04

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat (Android): setTransitionDuration on Android#3698

feat (Android): setTransitionDuration on Android#3698
FilPag wants to merge 6 commits intosoftware-mansion:mainfrom
FilPag:main

FilPag commented Feb 26, 2026 •

edited

Loading

Uh oh!

FilPag commented Mar 6, 2026

Uh oh!

kkafar commented Mar 7, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

kmichalikk left a comment

Uh oh!

kmichalikk May 7, 2026

Uh oh!

kmichalikk May 7, 2026

Uh oh!

kmichalikk May 7, 2026

Uh oh!

kmichalikk May 7, 2026

Uh oh!

FilPag commented May 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

FilPag commented Feb 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Changes

Before & after - visual documentation

Test plan

Checklist

Uh oh!

FilPag commented Mar 6, 2026

Uh oh!

kkafar commented Mar 7, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

kmichalikk left a comment

Choose a reason for hiding this comment

Uh oh!

kmichalikk May 7, 2026

Choose a reason for hiding this comment

Uh oh!

kmichalikk May 7, 2026

Choose a reason for hiding this comment

Uh oh!

kmichalikk May 7, 2026

Choose a reason for hiding this comment

Uh oh!

kmichalikk May 7, 2026

Choose a reason for hiding this comment

Uh oh!

FilPag commented May 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

FilPag commented Feb 26, 2026 •

edited

Loading