virtual-file-routes

Programmatically build a TanStack Router route tree by using code-first helpers like rootRoute, index, route, and layout to explicitly define your route structure instead of relying on filesystem conventions.

Yes, you can mix virtual and physical routes in TanStack Router by using the physical route helper alongside virtual route definitions, allowing explicit control over route trees that integrate both programmatic and file-based structures.

The best way to manage modular route subtree configurations is using the defineVirtualSubtreeConfig helper, which allows you to compose modular route sections programmatically before integrating them into the main routing config.

Virtual file routing integrates seamlessly with the TanStack Router plugin to assemble a full routing config, allowing your programmatically defined route tree to be processed by the plugin's build pipeline.

Use programmatic routing instead of file-based conventions when you need explicit control over your TanStack Router route tree, or when your code-first app requires mixing virtual and physical routes with modular subtree configurations.