AGENT SKILL

preact-persist

Gate Preact UI on Persist hydration with useHydrated (preact/compat useSyncExternalStore). Use when avoiding flash of default state on async backends or wiring HydrationSignal into Preact.

License 许可
MIT
最近更新
2026-11-01
Stars
★ 5
Forks
0

01 前言 Front Matter

name
preact-persist
license
MIT
sources
[ "stainless-code/persist:src/adapters/frameworks/preact.ts" ]
metadata
{ "type": "framework", "library": "@stainless-code/persist", "framework": "preact", "library_version": "0.4.1" }
requires
[ "persist" ]
description
Gate Preact UI on Persist hydration with useHydrated (preact/compat useSyncExternalStore). Use when avoiding flash of default state on async backends or wiring HydrationSignal into Preact.

03 SKILL.md 正文

Preact hydration gate

@stainless-code/persist/frameworks/preact mirrors the React adapter via preact/compat useSyncExternalStore (SSR snapshot always true). Not a state source — pair with a ./sources/* adapter.

Install

bun add @stainless-code/persist preact

Peer: preact >=10.19.0.

Minimal wiring

import { useHydrated } from "@stainless-code/persist/frameworks/preact";

const { hydrated } = useHydrated(prefsHydration);
if (!hydrated) return <Skeleton />;
return <PrefsView />;

prefsHydration = toHydrationSignal(persist) from your store module.

Common mistakes

  • Importing /frameworks/react in a Preact app. Use this subpath.
  • Treating the hook as state. Read the store separately.
  • Null signal ≠ loading — means no persist → hydrated.

API surface

  • useHydrated(signal) → { hydrated: boolean }

See also: react-persist (same contract).

04 同仓库更多 Skills