router-core/type-safety

To enable type inference in TanStack Router without explicit generics, perform a one-time type registration using module declarations. This automatically infers types across Link, useNavigate, useParams, and useLoaderData.

Your useLoaderData hook returns untyped data because the root route types are not registered. Performing a one-time type registration propagates strong typing through context and loader data automatically across all file-based routes.

The best way to maintain type safety when code-splitting TanStack Router routes is using the getRouteApi utility. It enforces static type registration and keeps types precise without requiring unsafe casts or explicit annotations.

Yes, you can use file-based routes with TanStack Router and get full type narrowing. By registering types once and using hook narrowing with from selectors, type safety propagates through nested routes without explicit type casts.

No, you do not need to manually annotate ValidateLinkOptions for large TanStack Router applications. The type-inference-first architecture uses type utilities to keep types precise and scalable without explicit annotations.