René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Bug] --router-only main.tsx ignores getRouter() from router.tsx (router.tsx becomes dead code + duplicate Register declaration)","articleBody":"### Which project does this relate to?\n\nCreate Tanstack App\n\n### Describe the bug\n\nWhen scaffolding a Router-only SPA (`create --router-only`), the generated `src/router.tsx` exports a `getRouter()` factory, but the generated `src/main.tsx` does **not** use it. Instead, `main.tsx` builds its own router inline with `createRouter(...)`.\n\nAs a result:\n\n1. `router.tsx` / `getRouter()` is **dead code** - nothing imports it anywhere in a `--router-only` project.\n2. The `declare module '@tanstack/react-router' { interface Register { ... } }` block is **duplicated** in both `main.tsx` (`router: typeof router`) and `router.tsx` (`router: ReturnType\u003ctypeof getRouter>`).\n\nIn the default (TanStack Start) mode this is fine because Start consumes `getRouter()` from `router.tsx` as the entry, and `main.tsx` is not generated. But in `--router-only` mode the two files diverge and `router.tsx` is left orphaned.\n\n### Your Example Website or App\n\npnpx @tanstack/cli create --router-only\n\n### Steps to Reproduce the Bug or Issue\n\n1. `pnpx @tanstack/cli create --router-only`\n2. Open `src/main.tsx` and `src/router.tsx`\n3. Grep the project for `getRouter` -> only defined in `router.tsx`, never imported\n(No StackBlitz needed - this is reproducible purely from the CLI output.)\n\n### Expected behavior\n\nIn `--router-only` mode, `main.tsx` should import and use `getRouter()` from `router.tsx`, and the `Register` module augmentation should live in a single place (`router.tsx`). Something like:\n\n```tsx\nimport ReactDOM from 'react-dom/client'\nimport { RouterProvider } from '@tanstack/react-router'\nimport { getRouter } from './router'\n\nconst router = getRouter()\n\nconst rootElement = document.getElementById('app')!\n\nif (!rootElement.innerHTML) {\n  const root = ReactDOM.createRoot(rootElement)\n  root.render(\u003cRouterProvider router={router} />)\n}\n```\n\nThis keeps a single source of truth for router configuration across both Start and Router-only modes, removes the dead `getRouter()`, and removes the duplicate `Register` declaration.\n\n### Screenshots or Videos\n\n_No response_\n\n### Platform\n\n- OS: macOS\n- @tanstack/cli: 0.69.5\n\n### Additional context\n\n- `packages/create/src/frameworks/react/project/base/src/main.tsx.ejs`\n- Line 1: `\u003c% if (!routerOnly) { ignoreFile() } %>` -> only emitted for router-only\n- Lines 6-16: creates its own `router` + declares `Register` instead of importing `getRouter`\n- `packages/create/src/frameworks/react/project/base/src/router.tsx.ejs`\n- No `ignoreFile()` guard -> always emitted, exports `getRouter()` + declares `Register`\n\nThe Solid templates have an identical structure:\n- `packages/create/src/frameworks/solid/project/base/src/main.tsx.ejs`\n- `packages/create/src/frameworks/solid/project/base/src/router.tsx.ejs`","author":{"url":"https://github.com/gs0428","@type":"Person","name":"gs0428"},"datePublished":"2026-06-25T12:54:42Z","url":"https://github.com/TanStack/cli/issues/480"}