Jetpack AppState - Code recipes

Jetpack AppState (StateStore and Transform) is a suite of libraries for managing, sharing, and transforming application state across Android components and UI surfaces. This repository contains recipes demonstrating how to use its APIs to implement common state management use cases. Each recipe introduces a single concept.

Recipes on the main branch use a pinned snapshot build, bumped regularly, of AppState.

These are the recipes and what they demonstrate.

• Browser Multi-Window Navigation (:apps:browser): A standalone multi-window and multi-tab browser application coordinating Navigation 3 back stacks across Activity windows via StateStore and DataStore persistence.

• Debounce: Demonstrates how to debounce rapidly changing state (such as search queries) using DebounceEffect and rememberDebounced.
• Sample: Demonstrates how to periodically sample high-frequency state streams (such as accelerometer sensor data) using SampleEffect and rememberSampled.

Full-app recipes live under apps/* (such as apps/browser/). Each is an independent Android application module that can be launched directly via its own Android Studio Run Configuration (e.g. apps.browser) or deployed to a device and opened from the main Recipe Picker (:app). Shared architecture components (like StateStoreOwner, StateStoreViewerActivity, and common theming) are provided by the shared :core library module.

The most upvoted recipe requests will be considered for implementation. Don't see your recipe? File a request for one here.

Full apps that combine several AppState APIs in a realistic, multi-screen setting.

• GitHub Browser: A Jetpack Compose GitHub client (search repositories, view repository details, contributors, and user profiles, and sign in with GitHub). It shows how to use StateStore to handle authentication: the access token and signed-in user live in one shared StateStore, persisted with statestore-datastore, so the network layer, repositories, and every screen stay in sync when you sign in or out. It also shows how to use Transform for state management throughout the app: each ViewModel builds its UI state with transform instead of StateFlow pipelines.
• Chat AppFunctions: A chat app for phone and Wear OS that exposes its features to on-device AI agents through AppFunctions. It shows how to use StateStore to share application-level state, such as the signed-in user and the screen being shown, between the AppFunctions service and the UI, so agents can change the app's state with functions like changeUser and changeScreen and the open app reacts right away.

Clone this repository and open the root folder in Android Studio. Each recipe is contained in its own package with its own Activity and README.md. Each sample app is its own Gradle module (for example :githubbrowser) with its own run configuration and README.md.

If the issue is directly related to this project, as in, it's reproducible without modifying this project's source code, then please file an issue on GitHub. If you've found an issue with the Jetpack AppState libraries (StateStore or Transform), please file an issue on the issue tracker.

We'd love to accept your contributions. Please follow these instructions.

Copyright 2026 The Android Open Source Project

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.