Learn / From declarations to the screen

From a changed field to a query

When foldkit-remote receives a Product update that changes price, it compares the changed fields against PublishedByPrice's declared predicate and order dependencies, along with the loaded pages in the cache:

  • Non-matching field: Changing name touches neither status nor price, so held lists keep their current order without refetching.
  • Ordering or predicate field: Changing price or status moves the row inside a loaded segment when all required fields and boundaries are known. When page boundaries or server filters leave the client uncertain, Remote invalidates the connection so active Surfaces refetch.

To inspect why a query is in its current state (Loading, stale, or holding a pending write), call explain and why from foldkit-remote/why with your active Surfaces (options.surfaces). See the Remote guide for read states, freshness, and live updates.