Virtual File Routes (@tanstack/virtual-file-routes)

Build route trees programmatically instead of relying on filesystem conventions. Useful when you want explicit control over route structure, need to mix virtual and physical routes, or want to define route subtrees within file-based routing directories.

CRITICAL: Types are FULLY INFERRED. Never cast, never annotate inferred values.

Install

npm install @tanstack/virtual-file-routes

API Reference

rootRoute(file, children?)

Creates the root of a virtual route tree.