You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[Due for payment 2026-07-21] iOS - AI promo modal - Transition animations stutter when moving between tiles on the carousel #93985
Version Number: 9.4.15-1 Reproducible in staging?: Yes Reproducible in production?: N/A - new feature, doesn't exist in prod If this was caught during regression testing, add the test name, ID and link from BrowserStack:#92007 Email or phone of affected tester (no customers):gatantm+665@gmail.com Issue reported by: Applause Internal Team Bug source: Exploratory - Significant User Experience Deterioration Device used: iPhone 12 mini, iOS 16.7, iPhone 16 Pro Max, iOS 18.7.7 App Component: Other
Action Performed:
Launch the app
Login to see the new promo
Swipe ot tap next to move between the tiles
Expected Result:
The animation is smooth between the tiles
Actual Result:
The transition animations stutter when moving between tiles on the carousel
👋 Friendly reminder that deploy blockers are time-sensitive ⏱ issues! Check out the open `StagingDeployCash` deploy checklist to see the list of PRs included in this release, then work quickly to do one of the following:
Identify the pull request that introduced this issue and revert it.
Classification: Frontend bug Causing PR: #92007 - "Concierge AI Feature Promo Modal" by @gijoe0295 (High confidence) Related Issues: #90820 (feature implementation issue)
Recommendation: ROLL FORWARD
This is a brand-new feature that does not exist in production, and the symptom is an animation performance issue (stutter) rather than a functional break — a targeted performance fix to the new carousel/Lottie code is preferable to reverting an extensively-reviewed feature PR.
Assigned: @gijoe0295 (PR author), @ShridharGoel (approving reviewer), @mjasikowski (approving reviewer) from highest-confidence causing PR only Labels: No label changes. DeployBlockerCash is correctly retained (App deploy is blocked, this is a frontend bug). No backend DeployBlocker label was present, so nothing to remove. Per the decision tree, since an App PR caused the issue we must keep DeployBlockerCash.
📋 Detailed Analysis
Evidence
The issue describes stuttering transition animations on the "AI promo modal" carousel when swiping/tapping between tiles on iOS.
This is a frontend-only change: the entire diff is in Expensify/App (React Native components, navigators, Lottie assets). There is no API/backend interaction in the carousel transition path, so the fix belongs in the App repo.
Verification
Affected/new files introduced by #92007 that own the carousel transition behavior:
src/components/FeatureTrainingModal/FeatureTrainingModalCarouselBody.tsx (new) — the horizontal FlatList carousel with pagingEnabled, pagination dots, and scrollToIndex for swipe/tap navigation.
src/components/FeatureTrainingModal/FeatureTrainingModalIllustration.tsx (new) — renders a Lottie animation per page and toggles play/reset based on isFocused.
src/components/AIFeaturesPromoModal/index.tsx (new) — wires the three AI promo tiles (SpendAnalysis, ExpenseAssistant, CustomAgents Lottie animations) into the carousel.
Confirmed via gh pr view 92007 --json files that the PR adds all of these files plus the three .lottie assets in assets/animations/.
Root Cause
The carousel renders a full-weight Lottie animation for every page inside the horizontal FlatList, and all pages are mounted simultaneously. In FeatureTrainingModalIllustration.tsx, each Lottie is rendered with autoPlay={isFocused} and loop, while an effect calls animationRef.current.play(0) / reset() on focus change:
On iOS, decoding/animating multiple Lottie animations on the JS/UI thread while a scrollToIndex/paging gesture is in flight competes for frame budget, producing the observed stutter during the inter-tile transition. The onViewableItemsChanged -> setCurrentPage state update (95% visibility threshold) also triggers a re-render of FeatureTrainingModalContent mid-transition, adding work right as the scroll settles.
Suggested roll-forward directions (for the assignees to evaluate):
Pause/freeze non-focused Lottie animations more aggressively, or render only the focused page's animation, so only one animation runs during a swipe.
Defer the currentPage/content re-render until the scroll fully settles (e.g. via onMomentumScrollEnd) to avoid re-rendering mid-transition.
Consider removeClippedSubviews/windowing so off-screen Lottie views are not driving frames during the gesture.
⚠️ Medium confidence — this is a rendering-performance (jank) issue, so the exact dominant factor should be confirmed with on-device profiling (Xcode Instruments / Flipper). The analysis below is from static review of #92007.
What is the root cause of that problem?
The promo carousel renders every page's Lottie animation inside a horizontal FlatList (AIFeaturesPromoModal/index.tsx passes SpendAnalysis, ExpenseAssistant, CustomAgents). On iOS, lottie-react-native rasterizes frames on the main thread, the same thread that drives the paging scroll — so an actively looping animation and the swipe animation contend for frames, which reads as stutter. Two things make the hitch land right at the transition:
The newly-focused animation restarts as the scroll settles.currentPage only updates when a page passes the 95% visibility threshold (onViewableItemsChanged → setCurrentPage, CarouselBody:134-141). That flips isFocused, and the effect calls animationRef.current.play(0) (Illustration:70-82) — a full animation (re)start fired at the exact moment the swipe is still decelerating.
Every mounted cell re-renders on each page change.renderItem is an inline closure over currentPage with no memoization (CarouselBody:233-249), so each setCurrentPage re-renders all illustration cells — extra main-thread work at the worst time.
Off-screen animations are only .reset() on blur; there is no gesture-aware pause/deferral. Note the Lottie wrapper's perf guards (shouldLoadAfterInteractions, pause-on-navigate) are web/browser-only and don't apply on native iOS (Lottie/index.tsx).
What changes do you think we should make in order to solve the problem?
Defer the focused animation's play(0) until the swipe settles — wrap it in InteractionManager.runAfterInteractions (mirroring the existing shouldLoadAfterInteractions pattern in Lottie) so the restart doesn't land mid-transition.
Memoize the carousel cell (extract a React.memo'd item component) and drive updates via the FlatListextraData={currentPage} prop instead of re-creating renderItem on every page change, so only the two affected cells re-render.
Pause off-screen animations rather than relying on a single focused/blurred state, and consider only mounting/playing the focused tile (render the first frame as a static placeholder for the rest).
What alternative solutions did you explore? (Optional)
The reporter's lowest-end device is an iPhone 12 mini; part of the stutter may be device-specific and amplified by heavy/high-framecount .lottie source assets — worth checking the asset weight too.
Confirming which factor dominates needs an on-device profile (Instruments Core Animation / Flipper), which I couldn't run here.
Investigation notes
Carousel: horizontal FlatList, pagingEnabled, getItemLayout based on carouselViewportWidth (CarouselBody:222-250).
Each page → FeatureTrainingModalIllustration → <Lottie ... autoPlay={isFocused} loop> (Illustration:163-171).
All affected files are in Expensify/App, so the fix can be made in this repo.
No duplicate open issues found in a quick scan.
Next Steps for Contributor+ team: To accept:@MelvinBot implement [this](https://github.com/Expensify/App/issues/93985) to create a draft PR. To refine:@MelvinBot <your feedback> To reject: Explain why you are rejecting Melvin's proposal.
changed the title [-]iOS - AI promo modal - Transition animations stutter when moving between tiles on the carousel[/-][+][Due for payment 2026-07-21] iOS - AI promo modal - Transition animations stutter when moving between tiles on the carousel[/+]on Jul 14, 2026
The solution for this issue has been 🚀 deployed to production 🚀 in version 9.4.33-8 and is now subject to a 7-day regression period 📆. Here is the list of pull requests that resolve this issue:
@gijoe0295 The PR fixing this issue has been merged! The following checklist (instructions) will need to be completed before the issue can be closed. Please copy/paste the BugZero Checklist from here into a new comment on this GH and complete it. If you have the K2 extension, you can simply click: [this button]. If no checklist is needed for this issue, you can click: [no checklist button]
Activity
melvin-bot commentedon Jun 18, 2026
You have been assigned to this deploy blocker because you recently merged this PR: #92007
melvin-bot commentedon Jun 18, 2026
💬 A slack conversation has been started in #expensify-open-source
github-actions commentedon Jun 18, 2026
👋 Friendly reminder that deploy blockers are time-sensitive ⏱ issues! Check out the open `StagingDeployCash` deploy checklist to see the list of PRs included in this release, then work quickly to do one of the following:
OSBotify commentedon Jun 18, 2026
🔍 Investigation Summary
Classification: Frontend bug
Causing PR: #92007 - "Concierge AI Feature Promo Modal" by @gijoe0295 (High confidence)
Related Issues: #90820 (feature implementation issue)
Recommendation: ROLL FORWARD
This is a brand-new feature that does not exist in production, and the symptom is an animation performance issue (stutter) rather than a functional break — a targeted performance fix to the new carousel/Lottie code is preferable to reverting an extensively-reviewed feature PR.
Assigned: @gijoe0295 (PR author), @ShridharGoel (approving reviewer), @mjasikowski (approving reviewer) from highest-confidence causing PR only
Labels: No label changes.
DeployBlockerCashis correctly retained (App deploy is blocked, this is a frontend bug). No backendDeployBlockerlabel was present, so nothing to remove. Per the decision tree, since an App PR caused the issue we must keepDeployBlockerCash.📋 Detailed Analysis
Evidence
Expensify/App(React Native components, navigators, Lottie assets). There is no API/backend interaction in the carousel transition path, so the fix belongs in the App repo.Verification
Affected/new files introduced by #92007 that own the carousel transition behavior:
src/components/FeatureTrainingModal/FeatureTrainingModalCarouselBody.tsx(new) — the horizontalFlatListcarousel withpagingEnabled, pagination dots, andscrollToIndexfor swipe/tap navigation.src/components/FeatureTrainingModal/FeatureTrainingModalIllustration.tsx(new) — renders aLottieanimation per page and toggles play/reset based onisFocused.src/components/AIFeaturesPromoModal/index.tsx(new) — wires the three AI promo tiles (SpendAnalysis, ExpenseAssistant, CustomAgents Lottie animations) into the carousel.Confirmed via
gh pr view 92007 --json filesthat the PR adds all of these files plus the three.lottieassets inassets/animations/.Root Cause
The carousel renders a full-weight
Lottieanimation for every page inside the horizontalFlatList, and all pages are mounted simultaneously. InFeatureTrainingModalIllustration.tsx, each Lottie is rendered withautoPlay={isFocused}andloop, while an effect callsanimationRef.current.play(0)/reset()on focus change:On iOS, decoding/animating multiple Lottie animations on the JS/UI thread while a
scrollToIndex/paging gesture is in flight competes for frame budget, producing the observed stutter during the inter-tile transition. TheonViewableItemsChanged->setCurrentPagestate update (95% visibility threshold) also triggers a re-render ofFeatureTrainingModalContentmid-transition, adding work right as the scroll settles.Suggested roll-forward directions (for the assignees to evaluate):
currentPage/content re-render until the scroll fully settles (e.g. viaonMomentumScrollEnd) to avoid re-rendering mid-transition.removeClippedSubviews/windowing so off-screen Lottie views are not driving frames during the gesture.MelvinBot commentedon Jun 18, 2026
Proposal
What is the root cause of that problem?
The promo carousel renders every page's Lottie animation inside a horizontal
FlatList(AIFeaturesPromoModal/index.tsxpassesSpendAnalysis,ExpenseAssistant,CustomAgents). On iOS,lottie-react-nativerasterizes frames on the main thread, the same thread that drives the paging scroll — so an actively looping animation and the swipe animation contend for frames, which reads as stutter. Two things make the hitch land right at the transition:currentPageonly updates when a page passes the 95% visibility threshold (onViewableItemsChanged→setCurrentPage, CarouselBody:134-141). That flipsisFocused, and the effect callsanimationRef.current.play(0)(Illustration:70-82) — a full animation (re)start fired at the exact moment the swipe is still decelerating.renderItemis an inline closure overcurrentPagewith no memoization (CarouselBody:233-249), so eachsetCurrentPagere-renders all illustration cells — extra main-thread work at the worst time.Off-screen animations are only
.reset()on blur; there is no gesture-aware pause/deferral. Note theLottiewrapper's perf guards (shouldLoadAfterInteractions, pause-on-navigate) are web/browser-only and don't apply on native iOS (Lottie/index.tsx).What changes do you think we should make in order to solve the problem?
play(0)until the swipe settles — wrap it inInteractionManager.runAfterInteractions(mirroring the existingshouldLoadAfterInteractionspattern inLottie) so the restart doesn't land mid-transition.React.memo'd item component) and drive updates via theFlatListextraData={currentPage}prop instead of re-creatingrenderItemon every page change, so only the two affected cells re-render.What alternative solutions did you explore? (Optional)
.lottiesource assets — worth checking the asset weight too.Investigation notes
FlatList,pagingEnabled,getItemLayoutbased oncarouselViewportWidth(CarouselBody:222-250).FeatureTrainingModalIllustration→<Lottie ... autoPlay={isFocused} loop>(Illustration:163-171).Expensify/App, so the fix can be made in this repo.Next Steps for Contributor+ team:
To accept:
@MelvinBot implement [this](https://github.com/Expensify/App/issues/93985)to create a draft PR.To refine:
@MelvinBot <your feedback>To reject: Explain why you are rejecting Melvin's proposal.
puneetlath commentedon Jun 18, 2026
Modal was reverted.
melvin-bot commentedon Jul 10, 2026
If you are the assigned CME please investigate whether the linked PR caused a regression and leave a comment with the results.
If a regression has occurred and you are the assigned CM follow the instructions here.
If this regression could have been avoided please consider also proposing a recommendation to the PR checklist so that we can avoid it in the future.
lanitochka17 commentedon Jul 10, 2026
Deploy Blocker #95856 was identified to be related to the PR #94012 that attempted to fix this issue.
melvin-bot commentedon Jul 10, 2026
If you are the assigned CME please investigate whether the linked PR caused a regression and leave a comment with the results.
If a regression has occurred and you are the assigned CM follow the instructions here.
If this regression could have been avoided please consider also proposing a recommendation to the PR checklist so that we can avoid it in the future.
[-]iOS - AI promo modal - Transition animations stutter when moving between tiles on the carousel[/-][+][Due for payment 2026-07-21] iOS - AI promo modal - Transition animations stutter when moving between tiles on the carousel[/+]melvin-bot commentedon Jul 14, 2026
Reviewinglabel has been removed, please complete the "BugZero Checklist".melvin-bot commentedon Jul 14, 2026
The solution for this issue has been 🚀 deployed to production 🚀 in version 9.4.33-8 and is now subject to a 7-day regression period 📆. Here is the list of pull requests that resolve this issue:
If no regressions arise, payment will be issued on 2026-07-21. 🎊
For reference, here are some details about the assignees on this issue:
melvin-bot commentedon Jul 14, 2026
@gijoe0295 The PR fixing this issue has been merged! The following checklist (instructions) will need to be completed before the issue can be closed. Please copy/paste the BugZero Checklist from here into a new comment on this GH and complete it. If you have the K2 extension, you can simply click: [this button]. If no checklist is needed for this issue, you can click: [no checklist button]