From 6faa32f8e345cd417ce1b9a4538419ae17d1864b Mon Sep 17 00:00:00 2001 From: Alan Silva Date: Sun, 18 Oct 2026 21:53:14 +0100 Subject: [PATCH 1/2] android: make Runs the default home --- .../src/main/java/net/awan/pipelines/ui/PipelinesApp.kt | 9 ++++++--- .../test/java/net/awan/pipelines/ui/PipelinesNavTest.kt | 5 +++++ docs/notes/runs-default-home.md | 7 +++++++ 3 files changed, 18 insertions(+), 3 deletions(-) create mode 100644 docs/notes/runs-default-home.md diff --git a/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt b/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt index d80f2ab1..c8399c4e 100644 --- a/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt +++ b/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt @@ -89,6 +89,9 @@ internal val destinations = listOf( TopDestination("settings", "Settings", Icons.Default.Settings), ) +/** The home route remains beneath top-level navigation, so Back returns to Runs. */ +internal const val HOME_ROUTE = "runs" + /** * Whether [route] is the current destination. Detail panes are no longer * separate routes (they are saved state inside a destination), so this is a @@ -210,7 +213,7 @@ fun PipelinesApp( is SearchTarget.Pipeline -> { pipelineSelection = PaneSelection(MasterPane.Detail, target.pipelineId, target.version) navController.navigate("pipelines") { - popUpTo("pipelines") { inclusive = false } + popUpTo(HOME_ROUTE) { inclusive = false } launchSingleTop = true } } @@ -274,7 +277,7 @@ fun PipelinesApp( val onNavigate: (TopDestination) -> Unit = { destination -> if (currentRoute != destination.route) { navController.navigate(destination.route) { - popUpTo("pipelines") { inclusive = destination.route == "pipelines" } + popUpTo(HOME_ROUTE) { inclusive = destination.route == HOME_ROUTE } launchSingleTop = true } } @@ -317,7 +320,7 @@ fun PipelinesApp( ) NavHost( navController = navController, - startDestination = "pipelines", + startDestination = HOME_ROUTE, // While the banner is visible it owns the status-bar inset, so // the inner app bars below must not apply it a second time. modifier = Modifier diff --git a/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt b/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt index 1347a1c5..538e801c 100644 --- a/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt +++ b/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt @@ -13,6 +13,11 @@ import org.junit.Test class PipelinesNavTest { + @Test + fun runsIsTheHomeRouteForColdLaunchAndTopLevelBack() { + assertEquals("runs", HOME_ROUTE) + } + @Test fun thePillDoesNotHoldTemplates() { // Templates is configuration and moved to the Settings page; the pill keeps diff --git a/docs/notes/runs-default-home.md b/docs/notes/runs-default-home.md new file mode 100644 index 00000000..b331cf59 --- /dev/null +++ b/docs/notes/runs-default-home.md @@ -0,0 +1,7 @@ +# Runs default home + +The Android app now starts at Runs. Top-level navigation and pipeline search pop up +to the Runs home route, while explicit run deep links continue to select their run. + +The shared Android navigation documentation may still describe Pipelines as the +initial destination; the `docs-fold` documentation pass should update that reference. From 72f976b63680c53dee8fa9bf7ee331b00444e252 Mon Sep 17 00:00:00 2001 From: Alan Silva Date: Sun, 18 Oct 2026 22:02:20 +0100 Subject: [PATCH 2/2] android: preserve Runs home navigation stack --- .../java/net/awan/pipelines/ui/PipelinesApp.kt | 16 +++++++++++----- .../net/awan/pipelines/ui/PipelinesNavTest.kt | 8 ++++++++ 2 files changed, 19 insertions(+), 5 deletions(-) diff --git a/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt b/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt index c8399c4e..6d915b11 100644 --- a/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt +++ b/android/app/src/main/java/net/awan/pipelines/ui/PipelinesApp.kt @@ -92,6 +92,10 @@ internal val destinations = listOf( /** The home route remains beneath top-level navigation, so Back returns to Runs. */ internal const val HOME_ROUTE = "runs" +/** Returning to home clears the accumulated top-level stack; other destinations keep it. */ +internal fun topLevelPopUpToHomeInclusive(destination: String): Boolean = + destination == HOME_ROUTE + /** * Whether [route] is the current destination. Detail panes are no longer * separate routes (they are saved state inside a destination), so this is a @@ -220,7 +224,7 @@ fun PipelinesApp( is SearchTarget.Run -> { runSelection = PaneSelection(MasterPane.Detail, target.runId) runSearchNav = target.takeIf { it.sequence > 0 } - navController.navigate("runs") { launchSingleTop = true } + navController.navigate(HOME_ROUTE) { launchSingleTop = true } } null -> Unit } @@ -234,7 +238,7 @@ fun PipelinesApp( val openRunFromAttention: (Long) -> Unit = { runId -> vm.arrivedAtRun(runId) runSelection = PaneSelection(pane = MasterPane.Detail, itemId = runId) - navController.navigate("runs") { launchSingleTop = true } + navController.navigate(HOME_ROUTE) { launchSingleTop = true } } // A deep link (or the notification's click action) opens its run once. The @@ -277,7 +281,9 @@ fun PipelinesApp( val onNavigate: (TopDestination) -> Unit = { destination -> if (currentRoute != destination.route) { navController.navigate(destination.route) { - popUpTo(HOME_ROUTE) { inclusive = destination.route == HOME_ROUTE } + popUpTo(HOME_ROUTE) { + inclusive = topLevelPopUpToHomeInclusive(destination.route) + } launchSingleTop = true } } @@ -347,11 +353,11 @@ fun PipelinesApp( pane = MasterPane.Detail, itemId = runId, ) - navController.navigate("runs") { launchSingleTop = true } + navController.navigate(HOME_ROUTE) { launchSingleTop = true } }, ) } - composable("runs") { + composable(HOME_ROUTE) { RunsDestination( vm = vm, wide = wide, diff --git a/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt b/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt index 538e801c..9e1cd4c8 100644 --- a/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt +++ b/android/app/src/test/java/net/awan/pipelines/ui/PipelinesNavTest.kt @@ -18,6 +18,14 @@ class PipelinesNavTest { assertEquals("runs", HOME_ROUTE) } + @Test + fun returningToHomeIsTheOnlyTopLevelNavigationThatClearsHome() { + assertTrue(topLevelPopUpToHomeInclusive(HOME_ROUTE)) + assertFalse(topLevelPopUpToHomeInclusive("pipelines")) + assertFalse(topLevelPopUpToHomeInclusive("chat")) + assertFalse(topLevelPopUpToHomeInclusive("settings")) + } + @Test fun thePillDoesNotHoldTemplates() { // Templates is configuration and moved to the Settings page; the pill keeps