# Store 6

> Store 6 is a Kotlin Multiplatform library for reading and writing data that lives in more than one
> place: a network, a local database, and memory. You describe a key and a fetcher; Store handles
> single-flighting concurrent demand, staleness, invalidation, and bounded memory. Every zero-config
> behavior is named and covered by a conformance test. Published under `store6-*` coordinates in the
> group `org.mobilenativefoundation.store`, side by side with Store 5 for the whole 6.x major.
> Status: in development, targeting 6.0.0-alpha01. Nothing is published yet.

## Start

- [Quickstart](https://store.mobilenativefoundation.org/llms/store6/quickstart.md): the five-line store, the full runnable program that CI compiles and runs on every pull request, and the experimental write path.
- [Important Defaults](https://store.mobilenativefoundation.org/llms/store6/important-defaults.md): every zero-config behavior — freshness, retry, cache and memory, single-flighting, emission — each line traceable to a named conformance test.

## Use Store

- [Keys and Namespaces](https://store.mobilenativefoundation.org/llms/store6/key-design.md): key design is the one skill Store asks you to learn. `StoreKey`, `StoreNamespace`, `canonicalId()`, and namespace-level operations.
- [Invalidate or Clear](https://store.mobilenativefoundation.org/llms/store6/invalidate-vs-clear.md): invalidate marks stale and refetches for live streams; clear removes and never replays. Which one you want, and why.

## Concepts

- [The read contract](https://store.mobilenativefoundation.org/llms/store6/concepts/read-contract.md): what `stream`, `get`, and the four `StoreResult` kinds guarantee.
- [Freshness](https://store.mobilenativefoundation.org/llms/store6/concepts/freshness.md): the freshness policies, conditional-fetch boundary, and stale-while-revalidate behavior.
- [Errors](https://store.mobilenativefoundation.org/llms/store6/concepts/errors.md): the six `StoreError` categories, error-as-value boundary, cancellation, and retry ownership.
- [Memory and lifecycle](https://store.mobilenativefoundation.org/llms/store6/concepts/memory-and-lifecycle.md): residency, idle-key bounds, Store lifetime, and persistence choices.
- [API tiers](https://store.mobilenativefoundation.org/llms/store6/concepts/api-tiers.md): stable-track, experimental, and delicate surfaces and their opt-in rules.

## Guides

- [Fetchers](https://store.mobilenativefoundation.org/llms/store6/guides/fetchers.md): lambda, result-aware, and seam fetchers, including conditional requests and retry composition.
- [Persistence](https://store.mobilenativefoundation.org/llms/store6/guides/persistence.md): the SourceOfTruth and Bookkeeper contracts and how to choose or certify an adapter.
- [Testing](https://store.mobilenativefoundation.org/llms/store6/guides/testing.md): fakes, contract kits, policy tests, and deterministic time.
- [Devtools and observability](https://store.mobilenativefoundation.org/llms/store6/guides/devtools.md): logging, telemetry, inspection hosts, and the runnable demo.
- [Extending Store](https://store.mobilenativefoundation.org/llms/store6/guides/extending.md): decorators, runtime capabilities, key events, overlay projection, and wall time.
- [Performance](https://store.mobilenativefoundation.org/llms/store6/guides/performance.md): measurement commands, benchmark scope, and evidence boundaries.
- [Swift](https://store.mobilenativefoundation.org/llms/store6/guides/swift.md): Objective-C export, SKIE, coroutine bridges, duration representation, and target coverage.
- [Room adapter](https://store.mobilenativefoundation.org/llms/store6/room.md): connect Store to an existing `androidx.room3` database and its sidecar metadata.
- [SQLDelight adapter](https://store.mobilenativefoundation.org/llms/store6/sqldelight.md): connect an existing SQLDelight schema with atomic value and metadata transactions.
- [Compose integration](https://store.mobilenativefoundation.org/llms/store6/compose.md): collect Store streams as Compose state without unstable recomposition.

## Mutations

- [Mutations overview](https://store.mobilenativefoundation.org/llms/store6/mutations.md): the journalled write path, experimental posture, and adoption sequence.
- [Mutations quickstart](https://store.mobilenativefoundation.org/llms/store6/mutations/quickstart.md): register a typed intent, project it optimistically, push it, and observe the acknowledgement.
- [Authoring mutators](https://store.mobilenativefoundation.org/llms/store6/mutations/mutators.md): the five registration shapes, codecs, purity, and invalidation effects.
- [Pending-write UI](https://store.mobilenativefoundation.org/llms/store6/mutations/pending-write-ui.md): render optimistic overlay state without confusing it with staleness.
- [MutationServer](https://store.mobilenativefoundation.org/llms/store6/mutations/server.md): implement push, idempotency, acknowledgement, conflict, and retirement transport.
- [Conflict resolution](https://store.mobilenativefoundation.org/llms/store6/mutations/conflicts.md): select preconditions, merge into a new generation, or accept server-wins.
- [Aliases and canonical rekeying](https://store.mobilenativefoundation.org/llms/store6/mutations/aliases.md): move a provisional identity to its server-assigned canonical key.
- [Draining and restart](https://store.mobilenativefoundation.org/llms/store6/mutations/drain-and-restart.md): keyed and global drain behavior, backoff, hydration, and replay.
- [Journal storage](https://store.mobilenativefoundation.org/llms/store6/mutations/journal-storage.md): choose the in-memory default, SQLDelight, or a custom storage seam.
- [Inspection and observability](https://store.mobilenativefoundation.org/llms/store6/mutations/inspection.md): durable pending and dead-letter truth versus advisory event flows.
- [Testing mutations](https://store.mobilenativefoundation.org/llms/store6/mutations/testing.md): certify journal storage, crash boundaries, and projector purity.

## Migration

- [Migrate from Store 5](https://store.mobilenativefoundation.org/llms/store6/migration/from-store5.md): map Store 5 concepts and APIs to Store 6, including side-by-side adoption and rollback boundaries.
- [Component map](https://store.mobilenativefoundation.org/llms/store6/migration/component-map.md): translate Store 5 components, policies, and extension points to their Store 6 equivalents.
- [Migrate from Store 4](https://store.mobilenativefoundation.org/llms/store6/migration/from-store4.md): move through Store 5 or adopt Store 6 directly, with explicit compatibility and validation checkpoints.

## Agents & LLMs

- [Agents overview](https://store.mobilenativefoundation.org/llms/store6/agents/overview.md): choose page copy, Markdown documentation, or the Store6 coding skill.
- [LLM context](https://store.mobilenativefoundation.org/llms/store6/agents/llm-context.md): select documentation and inspect its recorded source identity.
- [Agent skills](https://store.mobilenativefoundation.org/llms/store6/agents/agent-skills.md): install the Store6 skill and retrieve documentation matching your project.
- [Complete Store6 guides](https://store.mobilenativefoundation.org/llms-full.txt): the Store6 guide corpus, including agent setup pages.

## Project

- [Stability](https://store.mobilenativefoundation.org/llms/store6/stability.md): API tiers, the deprecation cycle, the release cadence commitment, how stability is verified from a released tag, and the mutations posture at alpha01.
- [Roadmap](https://store.mobilenativefoundation.org/llms/store6/roadmap.md): operating principles, the phase table, target windows, and how to contribute.
- [Contributing](https://store.mobilenativefoundation.org/llms/store6/contributing.md): how to get involved.