Class: TanStackReactRouterBridge

API / @xmachines/play-tanstack-react-router / TanStackReactRouterBridge

Defined in: play-tanstack-router/src/tanstack-router-bridge-base.ts:102

Shared TanStack Router adapter implementing RouterBridge protocol via RouterBridgeBase

Remarks

Extends RouterBridgeBase to handle all common lifecycle and sync logic; adds the TanStack-specific navigation and subscription methods shared by the React and Solid adapters.

Subscribes to router.history (not router.subscribe(“onBeforeLoad”)) so that back/forward browser navigation (popstate events) are also captured. The router.subscribe(“onBeforeLoad”) approach only works when TanStack’s Transitioner component is mounted (i.e. inside a full ). Since this bridge is used without , we must subscribe to the underlying history object directly — which is exactly what Transitioner does internally: router.history.subscribe(router.load).

Architectural Invariants:

INV-02 (Passive Infrastructure): Router reflects actor state, never decides
Actor validates all navigation via guards before URL changes

The class is concrete — it can be instantiated directly. The framework packages re-export or subclass it purely to bind the public adapter name (and, for Solid, to add the dispose() alias).

Example

const bridge = new TanStackRouterBridgeBase(router, actor, routeMap);
bridge.connect();
return () => bridge.disconnect();

Extends

RouterBridgeBase

Constructors

Constructor

new TanStackReactRouterBridge(
   router,
   actor,
   routeMap): TanStackRouterBridgeBase;

Defined in: play-tanstack-router/src/tanstack-router-bridge-base.ts:112

Create a TanStack Router bridge

Parameters

Parameter	Type	Description
`router`	`TanStackRouterLike`	TanStack Router instance (from `createRouter`)
`actor`	`RoutableActor`	XMachines actor instance
`routeMap`	`TanStackRouteMapLike`	Bidirectional mapping between state IDs and paths