01 / DECISION
When this primitive earns a place
Use KV for configuration, reference data, cached results, and other read-heavy values that tolerate propagation delay.
02 / ARCHITECTURE
Build the smallest defensible path
Choose stable keys and versioned values, set expiration deliberately, separate authoring from read paths, and define stale-read behavior.
- 01Name the contract
Use KV for configuration, reference data, cached results, and other read-heavy values that tolerate propagation delay.
- 02Add one primitive
Choose stable keys and versioned values, set expiration deliberately, separate authoring from read paths, and define stale-read behavior.
- 03Capture failure evidence
Read after writes from more than one location, exercise expiration and missing-key paths, and prove consumers accept stale versions safely.
03 / REPRODUCE
Evidence before confidence
Read after writes from more than one location, exercise expiration and missing-key paths, and prove consumers accept stale versions safely.
npx wrangler kv key put --binding=CACHE_KV sample-key sample-value04 / BOUNDARY
The production boundary
KV is not a coordination lock or a substitute for strongly consistent transactional state.
05 / FIRST-PARTY SOURCES
Keep first-party sources authoritative
Product behavior, limits, pricing, and availability can change. Re-check these sources before acting.