Skip to main content

Troubleshoot Reservoir Scope And Entry-Point Confusion

Symptoms​

You started in Reservoir, but the question now appears to be about component composition, generated contracts, or another layer outside the state model.

What This Usually Means​

Reservoir is the wrong primary entry point when the issue is not actually the client-state subsystem.

Probable Causes​

  • The task belongs to Refraction because it is really about the UI contract.
  • The task belongs to Inlet because it is really about generated full-stack alignment.

How To Confirm​

  • Stay in Reservoir only if the primary concern is store behavior, reducers, selectors, effects, middleware, or testing that model.

Resolution​

Use How To Choose A Reservoir Package Entry Point if the issue still belongs to Reservoir. Otherwise switch to the correct subsystem overview.

Verify The Fix​

You should be able to name the primary concern as state model, UI contract, generated composition, or domain behavior.

Prevention​

Start by identifying whether the immediate problem is state transition logic or UI rendering and interaction logic.

Summary​

Reservoir is the correct section only when the client-state subsystem is the core problem.

Next Steps​