Modo Overview

Modo is a simple and convenient state-based navigation library for Jetpack Compose. It offers a flexible and powerful way to manage navigation in your application.
The UI of Modo navigation is defined by NavigationState, which is a structure of Screen and ContainerScreen. You can easily modify NavigationState to suit your needs from any part of your application.

Main Idea

Each integration of Modo is a rooted tree (wiki) that can be displayed as follows:

Each node is a Screen or ContainerScreen.
Leaf nodes are Screens.
Inner nodes are ContainerScreens. They can contain other Screens or ContainerScreens in their NavigationState.
The root node is a RootScreen. You can have multiple roots in your app. See How to integrate Modo for details.

Modo is an easy-to-use library. Here are some of the most-used features of Modo navigation:

Screen is the basic unit of the UI. It displays content defined in the overridden fun Content(modifier: Modifier).
@Parcelize class SampleScreen( override val screenKey: ScreenKey = generateScreenKey() ) : Screen { @Composable override fun Content(modifier: Modifier) { Text( text = "Hello, Modo! Screen №$screenIndex", modifier = modifier ) } }
To navigate between screens in a stack, simply call forward() and back() on StackScreen, which is an implementation of ContainerScreen.
// 1. Taking the nearest stack screen val stackNavigation = LocalStackNavigation.current // 2. Performing navigation val onForwardClick = { stackNavigation.forward(SampleScreen()) }
For arbitrary state changes the built-in commands don't cover, pass a lambda that calculates the new state from the old one. For example, to remove every LoginScreen from the stack:
navigation.dispatch { oldState -> StackState(oldState.stack.filter { it !is LoginScreen }) }
To integrate Modo with your application, use rememberRootScreen inside a Fragment or Activity. You can use DefaultStackScreen as a default stack implementation.
setContent { val rootScreen = rememberRootScreen { DefaultStackScreen(SampleScreen()) } rootScreen.Content(Modifier.fillMaxSize()) }

To get started with Modo, check out our Quick Start Guide and explore the sample application to see how Modo can simplify your navigation needs.

Last modified: 20 May 2026