start: The requested module '@tanstack/router-generator' does not provide an export named 'CONSTANTS'

[erik-kroon]

Which project does this relate to?

Start

Describe the bug

i was updating a different library, ran the following command:
$ rm -rf bun.lock && rm -rf node_modules && rm -rf apps/*/node_modules && bun i
and afterwards my dev server won't start. at first it was something about @tanstack/react-start/config not exporting defineConfig, switched to @tanstack/react-start-config and now this err

$ vinxi dev --port=3001
vinxi v0.5.7
file:///Users/erik/autoseo/node_modules/@tanstack/react-start-config/dist/esm/vinxi-file-router.js:2
import { CONSTANTS as GENERATOR_CONSTANTS, startAPIRouteSegmentsFromTSRFilePath, } from '@tanstack/router-generator';
^^^^^^^^^
SyntaxError: The requested module '@tanstack/router-generator' does not provide an export named 'CONSTANTS'
at ModuleJob._instantiate (node:internal/modules/esm/module_job:134:21)
at async ModuleJob.run (node:internal/modules/esm/module_job:217:5)
at async ModuleLoader.import (node:internal/modules/esm/loader:316:24)
at async loadFile (file:///Users/erik/autoseo/node_modules/vinxi/lib/load-app.js:83:25)
at async loadApp (file:///Users/erik/autoseo/node_modules/vinxi/lib/load-app.js:137:19)
at async Object.run (file:///Users/erik/autoseo/node_modules/vinxi/bin/cli.mjs:76:17)
at async runCommand (file:///Users/erik/autoseo/node_modules/citty/dist/index.mjs:316:16)
at async runCommand (file:///Users/erik/autoseo/node_modules/citty/dist/index.mjs:307:11)
at async runMain (file:///Users/erik/autoseo/node_modules/citty/dist/index.mjs:445:7)

ERROR Cannot read properties of undefined (reading 'config') 12:02:19 PM

at Object.run (/Users/erik/autoseo/node_modules/vinxi/bin/cli.mjs:79:9)
at async runCommand (/Users/erik/autoseo/node_modules/citty/dist/index.mjs:316:16)
at async runCommand (/Users/erik/autoseo/node_modules/citty/dist/index.mjs:307:11)
at async runMain (/Users/erik/autoseo/node_modules/citty/dist/index.mjs:445:7)

ERROR Cannot read properties of undefined (reading 'config') 12:02:19 PM

error: script "dev" exited with code 1

Your Example Website or App

do not know how to reproduce unfortunately

Steps to Reproduce the Bug or Issue

i am unsure

Expected behavior

it should start

Screenshots or Videos

No response

Platform

"@tanstack/react-form": "^1.11.1",
"@tanstack/react-query": "^5.71.10",
"@tanstack/react-router": "^1.121.0",
"@tanstack/react-router-with-query": "^1.121.0",
"@tanstack/react-start": "^1.121.0",
"@tanstack/react-start-config": "^1.120.20",
"@tanstack/react-table": "8.21.2",
"@tanstack/router-plugin": "^1.121.0",

OS: macOS 14.6.1
Memory: 16 GiB
Architecture: aarch64

Additional context

app.config.ts:
import { defineConfig } from "@tanstack/react-start-config";
import viteTsConfigPaths from "vite-tsconfig-paths";
import tailwindcss from "@tailwindcss/vite";
import { cloudflare } from "unenv";
import nitroCloudflareBindings from "nitro-cloudflare-dev";

export default defineConfig({
tsr: {
appDirectory: "src",
},
vite: {
plugins: [
viteTsConfigPaths({
projects: ["./tsconfig.json"],
}),
tailwindcss(),
],
},

react: {
exclude: ["pg-cloudflare"],
},
server: {
preset: "cloudflare-module",
unenv: cloudflare,
modules: [nitroCloudflareBindings],
},
});

[irosadie]

I getting issue same thing with this case, how to solve @erik-reges

[lifeofcoding]

having the same issue.

[choopk]

Getting same issue

import { CONSTANTS as GENERATOR_CONSTANTS, startAPIRouteSegmentsFromTSRFilePath, } from '@tanstack/router-generator';
^^^^^^^^^
SyntaxError: The requested module '@tanstack/router-generator' does not provide an export named 'CONSTANTS'
at ModuleJob.instantiate (node:internal/modules/esm/module_job:123:21)
at async ModuleJob.run (node:internal/modules/esm/module_job:191:5)
at async ModuleLoader.import (node:internal/modules/esm/loader:336:24)
at async loadFile (file:///home/choopk/marvel/start-basic/node_modules/.pnpm/vinxi@0.5.6@types+node@22.15.30_db0@0.3.2_ioredis@5.6.1_jiti@2.4.2_lightningcss@1.30.1_436a3a01fa7710d20032261ed993d844/node_modules/vinxi/lib/load-app.js:83:25)
at async loadApp (file:///home/choopk/marvel/start-basic/node_modules/.pnpm/vinxi@0.5.6_@types+node@22.15.30_db0@0.3.2_ioredis@5.6.1_jiti@2.4.2_lightningcss@1.30.1_436a3a01fa7710d20032261ed993d844/node_modules/vinxi/lib/load-app.js:137:19)
at async Object.run (file:///home/choopk/marvel/start-basic/node_modules/.pnpm/vinxi@0.5.6_@types+node@22.15.30_db0@0.3.2_ioredis@5.6.1_jiti@2.4.2_lightningcss@1.30.1_436a3a01fa7710d20032261ed993d844/node_modules/vinxi/bin/cli.mjs:76:17)
at async runCommand (file:///home/choopk/marvel/start-basic/node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:316:16)
at async runCommand (file:///home/choopk/marvel/start-basic/node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:307:11)
at async runMain (file:///home/choopk/marvel/start-basic/node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:445:7)

ERROR Cannot read properties of undefined (reading 'config') 11:30:42 PM

at Object.run (node_modules/.pnpm/vinxi@0.5.6_@types+node@22.15.30_db0@0.3.2_ioredis@5.6.1_jiti@2.4.2_lightningcss@1.30.1_436a3a01fa7710d20032261ed993d844/node_modules/vinxi/bin/cli.mjs:79:9)
at async runCommand (node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:316:16)
at async runCommand (node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:307:11)
at async runMain (node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:445:7) 

[wobsoriano]

Same here. Our Clerk TanStack integration tests stopped working 👀

I had to pin the ff. versions in our e2e:

"dependencies": {
  "@tanstack/react-router": "1.120.17",
  "@tanstack/router-generator": "1.120.17",
  "@tanstack/react-router-devtools": "1.120.17",
  "@tanstack/react-start": "1.120.17",
  "@tanstack/react-start-config": "1.120.17",
  "@tanstack/router-plugin": "1.120.17",
  "@tanstack/react-start-client": "1.120.17",
  "@tanstack/react-start-plugin": "1.120.17",
  "@tanstack/react-start-server": "1.120.17",
  "@tanstack/start-server-core": "1.120.17",
  "@typescript-eslint/parser": "^7.18.0",
  "isbot": "^5.1.17",
  "react": "18.3.1",
  "react-dom": "18.3.1",
  "vinxi": "0.5.3"
},

This ensures that your node_modules will always resolve to a compatible set, avoiding the breaking changes until you are ready to migrate everything at once. If you skip one of them, then the lockfile/node_modules will resolve a mix of pre- and post-breaking-change versions

[SeanCassiere]

Looking at the stack traces here, it looks like you haven't done the devinxi migration. From release v1.121.0, Start moved away from Vinxi and is now a Vite Plugin (which requires Vite 6+).

The linked migration guide should get you most of the way.

Edit: We're still tracking all the options that changes in the config and we'll update that soon.

[junglebarry]

I had a similar issue with a different internal import:

--- import { generator, resolveConfigPath } from "@tanstack/router-generator";
--- SyntaxError: The requested module '@tanstack/router-generator' does not provide an export named 'generator'

It looks like router-generator's exports have changed quite substantially from 1.120 to 1.121, and generator is no longer exported - a breaking change.

However, the dependency-versioning strategy for using router-generator from, for instance, router-plugin is workspace:^:

router/packages/router-plugin/package.json

Line 114 in bab29d0

"@tanstack/router-generator": "workspace:^",

... so in my case, my existing router-plugin@1.120 had installed router-generator@1.121, which is incompatible.

Upgrading everything to 1.121 will fix the issues for me; pinning has worked for others. I'm sure there are other workarounds.

However, my question would be whether that workspace:^ versioning strategy is sound, given those breaking changes. Would workspace:* be more appropriate?

[choopk]

Looking at the stack traces here, it looks like you haven't done the devinxi migration. From release v1.121.0, Start moved away from Vinxi and is now a Vite Plugin (which requires Vite 6+).

The linked migration guide should get you most of the way.

Edit: We're still tracking all the options that changes in the config and we'll update that soon.

https://tanstack.com/start/latest/docs/framework/react/hosting

The docs for cloudflare is not updated for the devinxi migration