# Zhuinden/simple-stack

[ACTIVE] Simple Stack, a backstack library / navigation framework for simpler navigation and state management (for fragments, views, or whatevers).

Repository: https://github.com/Zhuinden/simple-stack
Canonical: https://ross.abutalabs.com/products/simple-stack
Language: Java
License: Apache-2.0
License Family: permissive
Topics: backstack, state-persistence, navigation, android, single-activity-pattern, fragments, simple-stack
Last push: 2025-12-25T08:10:25+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 59, release rhythm 31, longevity 100
- inputs: {"age_days": 3520, "days_push": 251, "days_rel": 251, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1378, forks 77 (observed 2026-08-28T04:04:33.530169+00:00)

## What it is
Simple Stack is an Android backstack library and navigation framework that represents navigation state as a list of immutable, parcelable keys. It handles navigation history persistence across configuration changes and process death, with scoped state sharing between screens using fragments, views, or composables.

## Use cases
- navigate between screens with backstack.goTo() instead of FragmentTransactions
- preserve navigation history across process death and configuration changes
- share scoped data between screens in a single-activity Android app
- implement single-activity navigation with fragments or custom views
- support predictive back gesture with centralized back handling
- replace Jetpack Navigation with a simpler key-based backstack

## When to choose
- building Android apps with single-activity architecture
- you want predictable, centralized navigation with immutable state keys
- you need automatic navigation state persistence across process death
- you use fragments, custom views, or Compose and want a navigation-agnostic backstack

## When to avoid
- building multi-activity apps with platform navigation
- you prefer Jetpack Navigation's XML/Compose route-based API
- targeting non-Android JVM platforms

## Facets
- artifact type: library
- maturity: active
- function: state-management, routing, middleware
- domain: mobile-development, android-tools, developer-tools
- platform: jvm
- tags: backstack, navigation, single-activity, fragments, state-persistence, kotlin, java, android, mobile

## Member repositories
- Zhuinden/simple-stack (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:33.530169+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:40:21.223660+00:00, confidence not recorded.
  - readme: https://github.com/Zhuinden/simple-stack (fetched 2026-08-28T04:04:33.530169+00:00, sha 61eb51db454a)
- Data as of 2026-08-30T08:39:29.467469+00:00.