Learn how to establish and manage state in your Compose-based app and how to configure the UI to react to changes in state. See how to create observable states, how to retain state across recompositions or configuration changes, and how to structure your composables for optimal data flow.
Key points
- If your app's state is internal to a composable, use
rememberto persist the state across re-composition. - Use
rememberSaveableto persist the state across configuration changes. - State hoisting is a programming pattern where you move the state to the caller of a composable. Where possible, use state hoisting to make the composable more reusable and testable.
- Use the
ViewModelclass to hold an exposed state in an observable state holder, better encapsulating the state and creating a single source of truth for the UI.
Resources
Collections that contain this guide
This guide is part of these curated Quick Guide collections that cover broader Android development goals:
Compose basics (video collection)
This series of videos introduces various Compose APIs,
quickly showing you what’s available and how to use them.
Have questions or feedback
Go to our frequently asked questions page and learn about quick guides or reach out and let us know your thoughts.