CepatEdge

Appearance

ADR-011: TanStack Query for Frontend Server State ​

Status: Accepted
Date: 2026-03-09
Deciders: CepatEdge maintainers

Context ​

Frontend has many server-backed datasets (users, maintenance, analytics, logs, audit) that need caching, invalidation, and consistent fetch state.

Decision ​

Adopt TanStack Query for server state and keep service modules as transport wrappers over API core.

Consequences ​

Positive ​

  • Standard query/mutation patterns
  • Better cache and invalidation handling
  • Less repeated fetch/state boilerplate in pages

Negative ​

  • Additional abstraction layer to learn for new contributors
  • docs/frontend/query/tanstack.md
  • docs/frontend/query/migration-plan.md
  • docs/frontend/api/core.md