[Due for payment 2025-02-27] [$250] Workspace - Inconsistent back navigation when clicking app back button

[mitarachim]

If you haven’t already, check out our contributing guidelines for onboarding and email contributors@expensify.com to request to join our Slack channel!

---

Version Number: v9.0.83-5
Reproducible in staging?: Yes
Reproducible in production?: Yes
If this was caught on HybridApp, is this reproducible on New Expensify Standalone?: N/A
If this was caught during regression testing, add the test name, ID and link from TestRail: N/A
Email or phone of affected tester (no customers): expensify416+da2@gmail.com
Issue reported by: Applause Internal Team
Device used: MacOS Chrome, Desktop
App Component: Other

Action Performed:

1. Navigate to a workspace chat
2. Click on header > Go to Workspace
3. Click on browser back button
4. Click on Go to Workspace button
5. Click on app back button next workspace avatar

Expected Result:

User should be navigated back to workspace chat details page the same way as it does for browser back button

Actual Result:

User is navigated back to workspace list page

Workaround:

Unknown

Platforms:

• Android: Standalone
• Android: HybridApp
• Android: mWeb Chrome
• iOS: Standalone
• iOS: HybridApp
• iOS: mWeb Safari
• MacOS: Chrome / Safari
• MacOS: Desktop

Screenshots/Videos

Bug6713719_1736841131876.Screen_Recording_2025-01-14_at_10.44.03_in_the_morning.mp4

View all open jobs on GitHub

Upwork Automation - Do Not Edit

• Upwork Job URL: https://www.upwork.com/jobs/~021879341293709833562
• Upwork Job ID: 1879341293709833562
• Last Price Increase: 2025-01-29
• Automatic offers:
• daledah | Contributor | 105926587

Issue Owner

Current Issue Owner: @maddylewis

[melvin-bot]

Triggered auto assignment to @maddylewis (Bug), see https://stackoverflow.com/c/expensify/questions/14418 for more details. Please add this bug to a GH project, as outlined in the SO.

[daledah]

Proposal

Please re-state the problem that we are trying to solve in this issue.

Workspace - Inconsistent back navigation when clicking app back button

What is the root cause of that problem?

We are using normal navigate when we click 'go to workspace' button

App/src/pages/ReportDetailsPage.tsx

Lines 510 to 515 in 12f4847

	if (isSmallScreenWidth) {
	Navigation.navigate(ROUTES.WORKSPACE_INITIAL.getRoute(report?.policyID));
	return;
	}
	Navigation.navigate(ROUTES.WORKSPACE_PROFILE.getRoute(report?.policyID));
	},

And call dismissModal when clicking back button here

App/src/pages/workspace/WorkspaceInitialPage.tsx

Lines 399 to 408 in 12f4847

	<HeaderWithBackButton
	title={policyName}
	onBackButtonPress={() => {
	if (route.params?.backTo) {
	Navigation.resetToHome();
	Navigation.isNavigationReady().then(() => Navigation.navigate(route.params?.backTo as Route));
	} else {
	Navigation.dismissModal();
	}
	}}

What changes do you think we should make in order to solve the problem?

We should update type of this navigate to type CONST.NAVIGATION.TYPE.UP to workspace chat this will make sure that we replace the appropriate screen at the root

      action: () => {
          if (!report?.policyID) {
              return;
          }
          if (isSmallScreenWidth) {
              Navigation.navigate(ROUTES.WORKSPACE_INITIAL.getRoute(report?.policyID), CONST.NAVIGATION.TYPE.UP );
              return;
          }
          Navigation.navigate(ROUTES.WORKSPACE_PROFILE.getRoute(report?.policyID), CONST.NAVIGATION.TYPE.UP );
      },

What specific scenarios should we cover in automated tests to prevent reintroducing this issue in the future?

NA

What alternative solutions did you explore? (Optional)

OR we can add backTo to route WORKSPACE_INITIAL and WORKSPACE_PROFILE and value it with Navigation.getActiveRoute()

App/src/pages/ReportDetailsPage.tsx

Lines 510 to 515 in 12f4847

	if (isSmallScreenWidth) {
	Navigation.navigate(ROUTES.WORKSPACE_INITIAL.getRoute(report?.policyID));
	return;
	}
	Navigation.navigate(ROUTES.WORKSPACE_PROFILE.getRoute(report?.policyID));
	},

Reminder: Please use plain English, be brief and avoid jargon. Feel free to use images, charts or pseudo-code if necessary. Do not post large multi-line diffs or write walls of text. Do not create PRs unless you have been hired for this job.

[huult]

🚨 Edited by proposal-police: This proposal was edited at 2025-01-16 16:11:04 UTC.

Proposal

Please re-state the problem that we are trying to solve in this issue.

Inconsistent back navigation when clicking app back button

What is the root cause of that problem?

We did not send backTo when opening the workspace

App/src/pages/ReportDetailsPage.tsx

Lines 510 to 514 in c0f5173

	if (isSmallScreenWidth) {
	Navigation.navigate(ROUTES.WORKSPACE_INITIAL.getRoute(report?.policyID));
	return;
	}
	Navigation.navigate(ROUTES.WORKSPACE_PROFILE.getRoute(report?.policyID));

So, when we go back from HeaderWithBackButton, it will call Navigation.dismissModal();

App/src/pages/workspace/WorkspaceInitialPage.tsx

Line 406 in bc3351d

Navigation.dismissModal();

The latest route is FULL_SCREEN_NAVIGATOR, and this page is Settings_Workspaces. As a result, the workspace init page is displayed, causing this issue to occur.

App/src/libs/Navigation/dismissModal.ts

Line 19 in 4ffbd42

const lastRoute = state.routes.at(-1);

What changes do you think we should make in order to solve the problem?

To fix this issue, we need to check if the navigation goes to FULL_SCREEN_NAVIGATOR, followed by SETTINGS.WORKSPACES, and then SCREENS.REPORT. If so, it indicates that we are on the report details page. With this approach, we don't need to check anything when navigating to the workspace. This is a global fix

App/src/pages/workspace/WorkspaceInitialPage.tsx

Line 406 in bc3351d

Navigation.dismissModal();

Update to:

        const state = navigationRef.current?.getRootState() as State<RootStackParamList>;
        const shouldPopHome =
            state.routes?.length >= 3 &&
            state.routes.at(-1)?.name === NAVIGATORS.FULL_SCREEN_NAVIGATOR &&
            state.routes.at(-2)?.name === SCREENS.SETTINGS.WORKSPACES &&
            state.routes.at(-3)?.name === SCREENS.REPORT &&
            getTopmostBottomTabRoute(state)?.name === SCREENS.SETTINGS.ROOT;

        if (shouldPopHome) {
            Navigation.resetToHome();
            navigationRef.goBack();
            Navigation.navigate(ROUTES.REPORT_WITH_ID_DETAILS.getRoute(`${currentUserPolicyExpenseChat?.reportID ?? CONST.DEFAULT_NUMBER_ID}`));
        } else {
            Navigation.dismissModal();
        }

POC

Screen.Recording.2025-01-14.at.23.03.58.mp4

What specific scenarios should we cover in automated tests to prevent reintroducing this issue in the future?

This is a UI bug and does not require testing.

What alternative solutions did you explore? (Optional)

Reminder: Please use plain English, be brief and avoid jargon. Feel free to use images, charts or pseudo-code if necessary. Do not post large multi-line diffs or write walls of text. Do not create PRs unless you have been hired for this job.

[melvin-bot]

Job added to Upwork: https://www.upwork.com/jobs/~021879341293709833562

[melvin-bot]

Triggered auto assignment to Contributor-plus team member for initial proposal review - @rojiphil (External)

[rojiphil]

Thanks for your proposals.

To fix this issue, we cannot use backTo or TYPE.UP because the issue will still occur if the page is refreshed and then the back button is clicked or go to other tab

@huult What issue will occur on using backTo and after the page is refreshed? Maybe I am missing something here.

we can add backTo to route WORKSPACE_INITIAL and WORKSPACE_PROFILE and value it with Navigation.getActiveRoute()

@daledah Using CONST.NAVIGATION.TYPE.UP does not seem to be the right thing to do and it also do not work for me. But using backTo may work. Can you please demonstrate that backTo works?

I think this is little tricky to solve as it could easily lead to regressions. Can you both please share a test branch based on your proposals to demonstrate that it works? Thanks.

[huult]

@rojiphil

If we use my solution, we don’t need to add backTo for each case. It’s safer because there’s no worry about missing a case.

Here is my test branch

Test branch

Here is the POC in my proposal

Screen.Recording.2025-01-14.at.23.03.58.mp4

@huult What issue will occur on using backTo and after the page is refreshed? Maybe I am missing something here.

I updated the proposal to remove this

[daledah]

POC.mov

@rojiphil here is my test branch

We just need to add backTo to the WORKSPACE_PROFILE route because the WORKSPACE_INITIAL route already has backTo before. Adding backTo to a route has been done a lot in App.