Tulip Logo IconTulip
Dependencies

TanStack Query

TanStack Query is the server-state cache and mutation layer used across Tulip data flows.

TanStack Query manages server state, caching, invalidation, and mutations.

Tulip uses it as the shared client-side data layer for ORPC-driven screens, command mutations, inline editing, tables, and app providers.

Where Tulip uses TanStack Query

  • @tulip-systems/app wraps apps in QueryClientProvider.
  • @tulip-systems/query/tanstack-query exports shared query client helpers.
  • Commands receive mutation options.
  • Inline editing receives mutation options.
  • Data Tables commonly load data with query options.
  • TanStack DB collections can reuse the shared query client.

What Tulip adds

Tulip adds a shared createQueryClient() and getQueryClient() with serializer and mutation invalidation conventions.

What your app owns

  • query keys
  • query functions
  • mutation functions
  • invalidation strategy
  • loading and error UX

Continue reading

On this page