From ed557600dfb24386252369ec9ca75a4c3945f8f3 Mon Sep 17 00:00:00 2001 From: Sutu Sebastian Date: Mon, 6 Jul 2026 17:02:04 +0300 Subject: [PATCH] docs(readme): add hero catchphrase + lead with flash/SSR-mismatch pains MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit New hero line under the H1: "Any store, any storage, one middleware — no flash." Rewrite the opening paragraph to lead with the two #1 documented pains (hydrate flash + SSR mismatch — per OSS issue scan across zustand/redux/query/pinia persist), then store-agnostic PersistableSource (TanStack first), the composable backend × codec × source seams (swap without rewriting), the hydration signal, and the capability breadth (cross-tab, versioned migrations, encrypted/compressed, retry-on-quota) + framework adapters. Aligns the README with the GitHub repo description. --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0fb7980..902945d 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # @stainless-code/persist -Hydration-aware persistence middleware for any reactive store — storage × codec seams, TanStack Store adapters, and a React hydration hook. Store-agnostic via a structural `PersistableSource`; every "can it do X?" is a one-line composition instead of a feature request. +**Any store, any storage, one middleware — no flash.** + +Hydration-aware persistence for any reactive store — no hydrate flash, no SSR mismatch. Store-agnostic via a structural `PersistableSource` (TanStack Store, zustand, jotai, valtio, mobx, or a hand-rolled atom); three composable seams (backend × codec × source) so you swap storage, serialization, or framework without rewriting. A first-class hydration signal gates UI on async backends; opt-in cross-tab sync, versioned migrations, encrypted/compressed backends, and retry-on-quota. Framework adapters for React, Solid, Vue, Svelte, Angular, and Preact. [![core size](https://img.shields.io/size-limit/label/gzip/.size-limit.json/core/stainless-code/persist)](https://github.com/stainless-code/persist/blob/main/.size-limit.json)