48:I[660678,["/_next/static/chunks/13vqyfldau57p.js","/_next/static/chunks/1gbl-dcot4vlq.js","/_next/static/chunks/3w7s_-pxil6pv.js","/_next/static/chunks/3zorfbfh_a_pd.js","/_next/static/chunks/0cnrn8dx8wpm6.js","/_next/static/chunks/2e4udl7tfg2xd.js","/_next/static/chunks/1mbdq0lktamc7.js","/_next/static/chunks/0nq310uz96h4-.js","/_next/static/chunks/2i4xo8xu-dpuk.js","/_next/static/chunks/40fmu66fmb8tm.js","/_next/static/chunks/3vehc-g2atkra.js","/_next/static/chunks/2a4jc680f5x-9.js","/_next/static/chunks/2wyk4b1ao4pa_.js","/_next/static/chunks/1gth09_ur0iam.js","/_next/static/chunks/0ugk39ckud30x.js","/_next/static/chunks/0pp6seif9t0rh.js","/_next/static/chunks/3bhq66ea_v7by.js","/_next/static/chunks/44c_5nh0vyeb5.js","/_next/static/chunks/1jiredr0b6jr_.js","/_next/static/chunks/0r86cplnpkdza.js","/_next/static/chunks/2ghxk472-g0i6.js","/_next/static/chunks/1ra7jqz5hyzln.js","/_next/static/chunks/42kj-we3o-c3u.js","/_next/static/chunks/2vvl77bxv5nze.js","/_next/static/chunks/2dk9hti1hh4ut.js","/_next/static/chunks/2l8l4_a9-xhts.js","/_next/static/chunks/1qsa_rj-5yj90.js","/_next/static/chunks/0ewjxq-e6quq-.js","/_next/static/chunks/34y7-26s89h2f.js","/_next/static/chunks/0ojgzwcpt7vsk.js","/_next/static/chunks/3enqpgm3pn7at.js","/_next/static/chunks/3-906s1ue5fj3.js","/_next/static/chunks/2t_5zfez2-77k.js","/_next/static/chunks/2641m2aqdum9a.js","/_next/static/chunks/1cvej8ocaz0a2.js","/_next/static/chunks/1j29bqcxcpyur.js"],"HydrationBoundary"] 47:T9d7,{"@context":"https://schema.org","@graph":[{"@type":"WebSite","@id":"https://app.codemod.com/registry#website","url":"https://app.codemod.com/registry","name":"Codemod Registry"},{"@type":"Organization","@id":"https://app.codemod.com#org","name":"amirabbas08dev@gmail.com","url":"https://app.codemod.com","logo":"https://avatars.githubusercontent.com/u/93479436?v=4"},{"@type":"BreadcrumbList","@id":"https://app.codemod.com/registry/nextjs-to-tanstack#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Registry","item":"https://app.codemod.com/registry"},{"@type":"ListItem","position":2,"name":"nextjs-to-tanstack","item":"https://app.codemod.com/registry/nextjs-to-tanstack"}]},{"@type":"WebPage","@id":"https://app.codemod.com/registry/nextjs-to-tanstack#webpage","url":"https://app.codemod.com/registry/nextjs-to-tanstack","name":"nextjs-to-tanstack - Codemod Registry","description":"Migrate a project from the Next.js App Router to TanStack Start","isPartOf":{"@id":"https://app.codemod.com/registry#website"},"author":{"@id":"https://app.codemod.com#org"},"breadcrumb":{"@id":"https://app.codemod.com/registry/nextjs-to-tanstack#breadcrumb"},"mainEntity":{"@id":"https://app.codemod.com/registry/nextjs-to-tanstack#sourcecode"}},{"@type":"SoftwareSourceCode","@id":"https://app.codemod.com/registry/nextjs-to-tanstack#sourcecode","name":"nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","url":"https://app.codemod.com/registry/nextjs-to-tanstack","publisher":{"@id":"https://app.codemod.com#org"},"image":"https://avatars.githubusercontent.com/u/93479436?v=4","isAccessibleForFree":true,"license":"MIT","codeRepository":"https://github.com/codemod/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","version":"1.3.12","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"datePublished":"2026-05-01 16:16:38.867214+00","dateModified":"2026-05-22 17:00:00.390288+00"},{"@type":"SoftwareApplication","@id":"https://app.codemod.com/registry/nextjs-to-tanstack#app","name":"nextjs-to-tanstack codemod","description":"Migrate a project from the Next.js App Router to TanStack Start","url":"https://app.codemod.com/registry/nextjs-to-tanstack","publisher":{"@id":"https://app.codemod.com#org"},"softwareVersion":"1.3.12","applicationCategory":"DeveloperApplication","operatingSystem":"Cross-platform","offers":{"@type":"Offer","price":"0","priceCurrency":"USD","availability":"https://schema.org/InStock"}}]}49:T2483,# nextjs-to-tanstack Migrate a **Next.js** app (App Router and common Pages Router usage) to **TanStack Start** and **TanStack Router** file routes. The workflow rewrites routes and handlers, updates tooling, and writes `TANSTACK_MIGRATION_NEXT_STEPS.md` next to `package.json` for remaining manual work. --- ## Quick start ```bash # Registry npx codemod run nextjs-to-tanstack # Monorepo: point at the Next.js package root npx codemod run nextjs-to-tanstack -t /path/to/next-app # This repo: run the bundled workflow npx codemod workflow run --workflow workflow.yaml --target . ``` Back up or commit first (recommended). Many files change; unmigrated `pages/` files may end up under `migrated-from-pages/`. The registry package name is `nextjs-to-tanstack` (same as in `codemod.yaml`). --- ## Workflow params Pass these when running [`workflow.yaml`](workflow.yaml) with `-p`: | Param | Type | Default | Meaning | | ------------------------ | --------------------- | --------- | ------------------------------------------------------- | | `enableAiFollowupFixups` | `"true"` \| `"false"` | `"false"` | Optional AI pass after deterministic steps (see below). | **`enableAiFollowupFixups`** — If `"true"`, an AI pass tries to clear low-risk `// TODO:` markers and tasks in `TANSTACK_MIGRATION_NEXT_STEPS.md`. Output is not fully deterministic; turn on only if you want that extra step. ```bash npx codemod workflow run --workflow workflow.yaml --target . \ -p enableAiFollowupFixups=true ``` --- ## What runs (overview) ### Layout and files - Adds a Vite / TanStack Start scaffold (e.g. `vite.config.ts`, router entry). If Next i18n is detected, hints may go under `.codemod/`. - Removes root Next-only configs (`next.config.*`, `postcss.config.*`). - Maps layouts to `__root.tsx`, `page` / `route` modules to `createFileRoute`, and API-style routes to TanStack server handlers. - Handles dynamic segments, `loading` / `error` / `not-found` / `template` files, and prunes empty App Router segment folders. ### Next.js APIs (mechanical rewrites) - `metadata` / `viewport` → route `head()`; `params` / `searchParams` → router hooks. - `next/link`, `next/image`, `next/navigation`, `next/dynamic`, `next/script` → TanStack-friendly patterns where safe. - `next/cache` → TanStack Query–style invalidation; `next/headers` → Start server helpers; `next/server` → Fetch `Request` / `Response` (gaps documented in the generated guide). - `next/og` → satori + resvg; `opengraph-image` / `twitter-image` → server `GET` routes. ### Data, types, and polish - Safe top-level `await` may move into `Route.loader`; harder cases get `// TODO:` (R10). - Pages data exports (`getStaticProps`, …) are stripped from migrated routes; Next-only types often become placeholders you should fix. - Fonts and `globals.css` get patches; unused `next/*` imports are dropped; survivors are annotated (R10b). ### Package, tooling, and exit - `package.json` picks up Start / Router / Vite deps and scripts. - tsconfig, ESLint, and doc/CI strings that assume Next get light patches. - Leftover `pages/` may move to `migrated-from-pages/`; `TANSTACK_MIGRATION_NEXT_STEPS.md` is written next to `package.json`. - Optional AI step if enabled; transient codemod state (e.g. `.codemod/state.json`) is removed afterward. ### Monorepos Globs match nested trees (e.g. `apps/foo/app/...`). In large repos, still pass `-t` at the Next package root so the run stays fast and focused. --- ## Supplementary notes - **Pipeline** — Steps run in a fixed order. Later passes assume earlier renames (e.g. `[slug]/page.tsx` → `$slug.tsx`) already happened, so re-running individual scripts by hand out of order may not match a full workflow run. - **Two outputs to trust** — Inline `// TODO: …` comments mark uncertain spots; `TANSTACK_MIGRATION_NEXT_STEPS.md` rolls those themes into a single checklist with doc links. - **Surface area** — The codemod targets common App Router and Pages Router paths (`app/**`, `pages/**`, shared components). Custom indirection (barrels, codegen, or non-standard folders) may need manual follow-up even when imports are valid. --- ## Before and after (illustrative) The snippets below mirror **fixture tests** in this repo. Your files may include extra imports, types, or TODOs until you finish the checklist. ### Dynamic page → TanStack file route **Before** — `src/app/posts/[slug]/page.tsx` ```tsx export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) { const { slug } = await params return

My Post: {slug}

} ``` **After** — `src/app/posts/$slug.tsx` (dynamic segment becomes a `$param` file name; URL shape is `createFileRoute("/posts/$slug")`) ```tsx import { createFileRoute } from '@tanstack/react-router' function PostPage() { const { slug } = Route.useParams() return

My Post: {slug}

} export const Route = createFileRoute('/posts/$slug')({ component: PostPage, }) ``` ### App Router API route → server `GET` handler **Before** — `src/app/api/hello/route.ts` ```tsx export async function GET() { return Response.json('Hello, World!') } ``` **After** — `src/app/api/hello.ts` (file moves up; HTTP methods live under `server.handlers`) ```tsx import { createFileRoute } from '@tanstack/react-router' export const Route = createFileRoute('/api/hello')({ server: { handlers: { GET: async () => { return Response.json('Hello, World!') }, }, }, }) ``` ### Root layout → `__root.tsx` **Before** — `src/app/layout.tsx` ```tsx import type { Metadata } from 'next' export const metadata: Metadata = { title: 'Create Next App', description: 'Generated by create next app', } export default function RootLayout({ children, }: Readonly<{ children: React.ReactNode }>) { return ( {children} ) } ``` **After** — `src/app/__root.tsx` (shell uses `Outlet`, `HeadContent`, and `Scripts`) ```tsx import type { Metadata } from 'next' import { Outlet, createRootRoute, HeadContent, Scripts } from '@tanstack/react-router' import appCss from './globals.css?url' export const metadata: Metadata = { title: 'Create Next App', description: 'Generated by create next app', } export const Route = createRootRoute({ component: RootLayout, }) function RootLayout() { return ( ) } ``` Later passes move `metadata` toward route `head()` and clean up remaining `next`-only types — expect to edit this file again while you work through `TANSTACK_MIGRATION_NEXT_STEPS.md`. ### Link: `next/link` → TanStack Router **Before** ```tsx import Link from 'next/link' ; About ``` **After** ```tsx import { Link } from '@tanstack/react-router' ; About ``` ### Redirects (server / loader style) **Before** — `next/navigation` ```tsx import { redirect, RedirectType } from 'next/navigation' export function guard() { redirect('/wish?error=invalid-thread-id', RedirectType.replace) } ``` **After** — throw `redirect` from `@tanstack/react-router` (appropriate in loaders, `beforeLoad`, and server code paths; client components use `useNavigate()` instead) ```tsx import { redirect } from '@tanstack/react-router' export function guard() { throw redirect({ to: '/wish?error=invalid-thread-id', replace: true }) } ``` Some call sites may still get a **TODO** comment if the codemod cannot prove the context is safe to rewrite. --- ## After you run 1. **Install** — Install deps so `package.json` edits take effect. Refresh lockfiles as needed; skip strict frozen installs until things stabilize. Watch for packages that still peer on Next. 2. **Open the checklist** — Read `TANSTACK_MIGRATION_NEXT_STEPS.md`: i18n, env (`NEXT_PUBLIC_*` → `VITE_*` / `import.meta.env`), OG URLs, TODO buckets (R10, R4e–R4i, …). It links to the official [Migrate from Next.js](https://tanstack.com/start/latest/docs/framework/react/migrate-from-next-js) guide. 3. **Sweep leftovers** — e.g. `rg '// TODO:'`, remaining `from "next/…"` imports, `middleware`, and `migrated-from-pages/` after you merge or delete what you need. 4. **Run the dev server** — `npm run dev` or `vite dev` from the package root; fix navigation, loaders, and tests (Vitest: see R4h-bis in the guide). This codemod is best-effort. Edge runtime, uncommon Next APIs, and app-specific design may still need manual work — the guide and TODOs are the source of truth. --- ## Development ```bash npm test codemod workflow validate --workflow workflow.yaml codemod login && codemod publish ``` ## Resources - [Migrate from Next.js (TanStack Start)](https://tanstack.com/start/latest/docs/framework/react/migrate-from-next-js) - [TanStack Router — routing concepts](https://tanstack.com/router/latest/docs/framework/react/routing/routing-concepts) - [TanStack Start — server routes](https://tanstack.com/start/latest/docs/framework/react/guide/server-routes) ## License MIT 19:[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"$47"}}],["$","$L48",null,{"state":{"mutations":[],"queries":[{"state":{"data":{"json":{"id":"758caa9d-9476-4f4d-8387-f39a1b1918a2","name":"nextjs-to-tanstack","displayName":"nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","scope":null,"visibility":"public","downloadCount":101,"executionCount":16,"createdAt":"2026-05-01 16:16:38.867214+00","updatedAt":"2026-05-22 17:00:00.390288+00","latestVersion":"1.3.12","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"starCount":0,"author":"Amirabbas Ghasemi ","homepage":null,"repository":"https://github.com/codemod/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","license":"MIT","access":"public","documentation":null,"bugsUrl":null,"readme":"$49","organization":{"id":null,"name":null,"slug":null,"avatarUrl":null},"owner":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com","avatarUrl":"https://avatars.githubusercontent.com/u/93479436?v=4"},"isLegacy":false,"versions":[{"version":{"id":"293a956c-cb14-450d-89ee-ae71f9ed1083","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.3.12","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.3.12","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/codemod/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"71b148fce4d7112825fc427d5a5ca0498020d572daa3c29506d2c46cc54b6f8f","size":258716,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.3.12/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":33,"cachedTestCases":{"input":"import axios from \"axios\";\nimport { createFileRoute } from \"@tanstack/react-router\";\n\nasync function ApiPage() {\n const res = await axios.get<{ title: string }>(\"/api/x\");\n console.log(res.status);\n\n return

{res.data.title}

;\n}\n\nexport const Route = createFileRoute(\"/api\")({\n component: ApiPage,\n});\n","output":"import axios from \"axios\";\nimport { createFileRoute } from \"@tanstack/react-router\";\n\nfunction ApiPage() {\n const res = Route.useLoaderData();\n\n return

{res.data.title}

;\n}\n\nexport const Route = createFileRoute(\"/api\")({\n component: ApiPage,\n\n loader: async () => {\n const res = await axios.get<{ title: string }>(\"/api/x\");\n console.log(res.status);\n return res;\n },\n});\n","filename":"api.tsx"},{"name":"app","path":"tests/annotate-async-pages/async-axios-interleaved/src/app","input":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/api.tsx\"\n },\n \"count\": 1\n }\n ]\n}","output":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/api.tsx\"\n },\n \"count\": 1\n }\n ]\n}","filename":"metrics.json"},{"name":"app","path":"tests/annotate-async-pages/async-fetch-comma-comment/src/app","input":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","output":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","filename":"metrics.json"},{"name":"app","path":"tests/annotate-async-pages/async-fetch-comma-comment/src/app","input":"import { createFileRoute } from \"@tanstack/react-router\";\n\nasync function PostsPage() {\n const res = await fetch(\"https://api.vercel.app/blog\");\n const posts = await res.json();\n return (\n

{post.title}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage, // keep trailing comma before comment\n});\n","output":"import { createFileRoute } from \"@tanstack/react-router\";\n\nfunction PostsPage() {\n const { res, posts } = Route.useLoaderData();\n return (\n

{post.title}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage, // keep trailing comma before comment\n\n loader: async () => {\n const res = await fetch(\"https://api.vercel.app/blog\");\n const posts = await res.json();\n return { res, posts };\n },\n});\n","filename":"posts.tsx"},{"name":"app","path":"tests/annotate-async-pages/async-fetch-utf8-prefix/src/app","input":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","output":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","filename":"metrics.json"},{"name":"app","path":"tests/annotate-async-pages/async-fetch-utf8-prefix/src/app","input":"import { createFileRoute } from \"@tanstack/react-router\";\n\nconst _utf8Pad = \"🚀\".repeat(120);\n\nasync function PostsPage() {\n const res = await fetch(\"https://api.vercel.app/blog\");\n const posts = await res.json();\n return (\n

{post.title}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage,\n});\n","output":"import { createFileRoute } from \"@tanstack/react-router\";\n\nconst _utf8Pad = \"🚀\".repeat(120);\n\nfunction PostsPage() {\n const { res, posts } = Route.useLoaderData();\n return (\n

{post.title}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage,\n\n loader: async () => {\n const res = await fetch(\"https://api.vercel.app/blog\");\n const posts = await res.json();\n return { res, posts };\n },\n});\n","filename":"posts.tsx"},{"name":"app","path":"tests/annotate-async-pages/async-fetch/src/app","input":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","output":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","filename":"metrics.json"},{"name":"app","path":"tests/annotate-async-pages/async-fetch/src/app","input":"import { createFileRoute } from \"@tanstack/react-router\";\n\nasync function PostsPage() {\n const res = await fetch(\"https://api.vercel.app/blog\");\n const posts = await res.json();\n return (\n

{post.title}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage,\n});\n","output":"import { createFileRoute } from \"@tanstack/react-router\";\n\nfunction PostsPage() {\n const { res, posts } = Route.useLoaderData();\n return (\n

{post.title}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage,\n\n loader: async () => {\n const res = await fetch(\"https://api.vercel.app/blog\");\n const posts = await res.json();\n return { res, posts };\n },\n});\n","filename":"posts.tsx"},{"name":"app","path":"tests/annotate-async-pages/async-multi-fetch-interleaved/src/app","input":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","output":"{\n \"nextjs-to-tanstack-r10-async-await\": [\n {\n \"cardinality\": {\n \"file\": \"src/app/posts.tsx\"\n },\n \"count\": 1\n }\n ]\n}","filename":"metrics.json"},{"name":"app","path":"tests/annotate-async-pages/async-multi-fetch-interleaved/src/app","input":"import { createFileRoute } from \"@tanstack/react-router\";\n\nasync function PostsPage() {\n const data = await fetch(\"https://api.vercel.app/blog\");\n const posts = await data.json();\n console.log(posts);\n const newFetch = await fetch(\"https://api.vercel.app/blog\");\n console.log(await newFetch.json());\n\n return (\n

{String(posts.length)}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage,\n});\n","output":"import { createFileRoute } from \"@tanstack/react-router\";\n\nfunction PostsPage() {\n const { data, posts, newFetch } = Route.useLoaderData();\n\n return (\n

{String(posts.length)}

\n );\n}\n\nexport const Route = createFileRoute(\"/posts\")({\n component: PostsPage,\n\n loader: async () => {\n const data = await fetch(\"https://api.vercel.app/blog\");\n const posts = await data.json();\n console.log(posts);\n const newFetch = await fetch(\"https://api.vercel.app/blog\");\n console.log(await newFetch.json());\n return { data, posts, newFetch };\n },\n});\n","filename":"posts.tsx"}]},"defaultWorkflowName":"default","createdAt":"2026-05-22T17:00:00.390Z","updatedAt":"2026-09-05 16:17:28.847925+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":{"packageVersionId":"293a956c-cb14-450d-89ee-ae71f9ed1083","status":"ready","generatedAt":"2026-07-21T16:16:19.198Z"},"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"d99e496f-187b-4a9a-8e84-36e64f8a8ec7","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.3.11","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.3.11","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"7a6cee79d20877f54ff5b8172cb6629f5aff9ee754e2ca0b6618bdef5689ebee","size":253595,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.3.11/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":10,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-21T16:25:38.593Z","updatedAt":"2026-09-06 12:29:45.604732+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"b88af45b-60dd-4ca2-87b6-2dbf486a5f33","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.3.10","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.3.10","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"69c2b55c77bc8f29bd7face9a33113ea4b7054e005461b6922d5a1a3d223e1a7","size":253606,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.3.10/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":6,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-21T16:09:18.431Z","updatedAt":"2026-09-06 12:29:45.740559+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"66685fa3-1cf6-444e-b72d-18fad9a0f18f","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.3.8","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.3.8","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"ee36a203af9012c9df02cf8796bd1eba825fd3944c918b0e96c74542dc3e725e","size":249026,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.3.8/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":8,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-15T23:05:04.154Z","updatedAt":"2026-09-06 12:29:45.721255+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"82a59aa1-6d10-4a56-9421-8ab10c332b16","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.3.7","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.3.7","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"b6d141526e4f83915b4b5c38a3895c9a25116bc78b6b3d42e1e9c14da156b284","size":247908,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.3.7/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":6,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-15T23:01:55.229Z","updatedAt":"2026-09-06 12:29:45.756658+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"prune-empty-next-route-dirs","name":"R2c — Remove empty Next.js `[segment]` / `[...]` dirs under app/","steps":[{"name":"Delete abandoned dynamic segment folders after page moves","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (conventional query keys + unwrap unstable_cache/cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries (['next-cache', …]); unwrap unstable_cache/cache; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"next/server → Fetch + edge UA + next/og ImageResponse + after/connection shims + type stubs (skip NextResponse.next / namespace / aliases)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → satori + @resvg/resvg-js + Response","steps":[{"name":"Replace ImageResponse with satori + Resvg PNG pipeline (Start/Vite)","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-next-metadata-images","name":"R4i-bis — opengraph-image / twitter-image → TanStack server GET routes","steps":[{"name":"Move metadata image modules to $segments + createFileRoute GET handlers","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Move safe top-level await into Route.loader + useLoaderData (TODO otherwise)","steps":[{"name":"Extract sequential top-level await into createFileRoute.loader (or TODO when unsafe)","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"5fbc1717-3228-42c7-ac66-72c6a296b6ee","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.2.5","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.2.5","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"0d1c9f4768cf4b450ccf8f95d1533a22d48ff9fe60cc46775c2dc9298790012d","size":202310,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.2.5/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (invalidateQueries / unwrap unstable_cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"Trim next/server imports; rename identifiers (skip next/rewrite middleware-only)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → @vercel/og","steps":[{"name":"Point OG imports at @vercel/og (package added in R11)","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":8,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-08T15:55:55.136Z","updatedAt":"2026-09-06 12:29:45.821319+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep","ai"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `metadata` / `viewport` exports to head() config","steps":[{"name":"Map metadata + viewport fields to head() meta / links","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation → TanStack Router (hooks, redirect, useRouter → useNavigate)","steps":[{"name":"next/navigation + next/router, usePathname/useSearch/useRouter/useParams, redirect, notFound, refresh→invalidate","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-internal-modules","name":"R4dist — next/dist + codegen strings (ApiError, path-to-regexp, dynamic import templates)","steps":[{"name":"Replace internal Next paths and pinned dynamic import strings","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-cache","name":"R4e — next/cache → TanStack Query (invalidateQueries / unwrap unstable_cache)","steps":[{"name":"revalidateTag · revalidatePath → queryClient.invalidateQueries; strip unstable_noStore","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-headers","name":"R4f — next/headers → @tanstack/start/server getCookie / setCookie / deleteCookie / getCookies / getHeaders","steps":[{"name":"cookies()/headers() → getCookie / setCookie / deleteCookie / getCookies / getHeaders[…]","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server","name":"R4h — next/server NextRequest/NextResponse → Request/Response (Fetch)","steps":[{"name":"Trim next/server imports; rename identifiers (skip next/rewrite middleware-only)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-server-vitest","name":"R4h-bis — Vitest — local NextRequest/NextResponse shims; strip vi.mock(next/server)","steps":[{"name":"Tests still using NextResponse.next/rewrite or vi.mock(next/server)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-og","name":"R4i — next/og → @vercel/og","steps":[{"name":"Point OG imports at @vercel/og (package added in R11)","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-types","name":"R10a-quater — Erase next/types and import type … from \"next\"","steps":[{"name":"Replace Next type-only surface with any; remove imports","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"ai-followup-fixups","name":"AI follow-up for remaining TODOs and migration guide tasks","steps":[{"name":"Apply safe fixes from TODOs and TANSTACK_MIGRATION_NEXT_STEPS.md","type":"ai"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"b619bf02-083e-4ddb-94c7-1d24903f0fd5","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.1.2","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.1.2","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"1a81a87f7524c601d32988749f1183291606e14256b4b6c6687a552cfb3628d6","size":155712,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.1.2/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":6,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-05T18:44:40.792Z","updatedAt":"2026-09-06 12:29:46.297233+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"3550a954-de21-40e3-81b8-c8cccab6f2cc","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.1.1","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.1.1","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"76697d85557cf82669cccd112cbebca162e715b78c6cfb0579b33407be9f8497","size":149652,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.1.1/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":8,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-05T17:26:15.041Z","updatedAt":"2026-09-06 12:29:46.454522+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"4de414a4-1b89-4baa-8688-ef11ab45e5cc","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.1.0","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.1.0","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"b4d17dcfc6feaab4cf4a701b8d1c142aaba575dc2b3a2b4a1a5bf6a5bedf0c2a","size":149001,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.1.0/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":8,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-05T16:47:06.021Z","updatedAt":"2026-09-06 12:29:46.515305+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx / _app.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — App route.ts + api/**/*.ts + Pages api/ → createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename (app + pages router)","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails-post-pages","name":"R2a — Truncate orphan text after first Route (after R2 wrap)","steps":[{"name":"Drop duplicate Route blocks / partial SSG tails early","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-dynamic-script","name":"R4c — next/dynamic + next/script (safe subset)","steps":[{"name":"dynamic → React.lazy; Script → native script when patterns are safe","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-i18next-imports","name":"R4d — next-i18next → react-i18next (cross-cutting)","steps":[{"name":"Shared components + all TS/JS — align with bootstrap I18next instance","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — TODO for async route components still awaiting at render","steps":[{"name":"Insert migration note when createFileRoute components use top-level await","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-next-pages-data","name":"R10a — Strip getStaticProps / next-i18next SSG / next/head from app routes","steps":[{"name":"Remove Pages data-fetching exports and migrate remaining imports","type":"js-ast-grep","language":"tsx"}]},{"id":"repair-route-file-tails","name":"R10a-bis — Truncate orphan text after first export const Route (app *.ts/*.tsx)","steps":[{"name":"Keep only the first createFileRoute(...)() block (fixes invalid tails on API routes and pages)","type":"js-ast-grep","language":"tsx"}]},{"id":"strip-unused-next-imports","name":"R10a-ter — Remove wholly-unused next/* imports","steps":[{"name":"Delete import statements when no binding is referenced","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-remaining-next-imports","name":"R10b — TODO for surviving next/* imports and middleware.ts","steps":[{"name":"Line-level // TODO before each remaining Next import","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"patch-cjs-root-configs-for-esm","name":"R11b — next-i18next.config.js CommonJS → ESM when type module","steps":[{"name":"Rewrite single module.exports in next-i18next.config.js to export default","type":"js-ast-grep","language":"json"}]},{"id":"patch-tooling-and-docs","name":"R13 — tsconfig / ESLint JSON / README & workflows (no adjacent Next peers)","steps":[{"name":"Strip Next tsconfig plugin, patch extends; replace next CLI refs in docs/CI","type":"js-ast-grep","language":"json"}]},{"id":"cleanup-legacy-pages","name":"R14 — Relocate or remove leftover pages/ directories","steps":[{"name":"Move unmigrated pages files to migrated-from-pages/ then delete pages/","type":"js-ast-grep","language":"json"}]},{"id":"ensure-app-root","name":"R14b — Ensure __root.tsx exists for TanStack route generation","steps":[{"name":"Write minimal src/app/__root.tsx (or app/__root.tsx) when missing","type":"js-ast-grep","language":"json"}]},{"id":"patch-root-i18n-provider","name":"R14c — I18nextProvider + src/i18n.ts when .codemod/i18n.json exists","steps":[{"name":"Bootstrap i18next, patch __root, preload i18n from router","type":"js-ast-grep","language":"json"}]},{"id":"write-migration-guide","name":"Manual migration checklist (next steps for humans)","steps":[{"name":"Write TANSTACK_MIGRATION_NEXT_STEPS.md beside migrated package.json","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"8877b24c-07c7-4fe9-b0b1-8327394de690","packageId":"758caa9d-9476-4f4d-8387-f39a1b1918a2","version":"1.0.0","description":"Migrate a project from the Next.js App Router to TanStack Start","manifest":{"name":"nextjs-to-tanstack","author":"Amirabbas Ghasemi ","license":"MIT","targets":{"versions":{},"languages":["tsx","ts","jsx","js","json","css"],"frameworks":[]},"version":"1.0.0","keywords":["nextjs","tanstack","migration","app-router","react","transformation"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/amirabbas-gh/tanstack-codemods/tree/main/codemods/nextjs-to-tanstack","description":"Migrate a project from the Next.js App Router to TanStack Start","dependencies":[],"schema_version":"1.0"},"checksum":"519a73ea92c9d5561d405fb658113e2d27e67934a1b3fc7b223bc6dbb75a9e93","size":63770,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/nextjs-to-tanstack/1.0.0/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — Convert route.ts to createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Async loaders (manual follow-up placeholder)","steps":[{"name":"No-op (automatic Route.loader extraction is intentionally skipped)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]},"validated":false,"validationErrors":null,"publishedBy":"1b36b661-daf1-44b2-b71e-f98fd0287592","deprecated":false,"deprecationMessage":null,"downloadCount":8,"cachedTestCases":null,"defaultWorkflowName":"default","createdAt":"2026-05-01T16:16:38.867Z","updatedAt":"2026-09-06 12:29:46.536826+00"},"publishedBy":{"id":"1b36b661-daf1-44b2-b71e-f98fd0287592","username":"Rayamand","name":"amirabbas08dev@gmail.com"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx","json","css"],"stepTypes":["js-ast-grep"],"workflowMetadata":{"nodes":[{"id":"cleanup-obsolete-files","name":"Delete Next.js config files","steps":[{"name":"Remove next.config.* and postcss.config.*","type":"js-ast-grep","language":"tsx"}]},{"id":"scaffold-tanstack-files","name":"Create vite.config.ts and router.tsx (TanStack Start scaffold)","steps":[{"name":"Write new config files (idempotent, skip if exist)","type":"js-ast-grep","language":"json"}]},{"id":"rewrite-root-layout","name":"R1 — Convert layout.tsx to __root.tsx","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-api-routes","name":"R6 — Convert route.ts to createFileRoute handlers","steps":[{"name":"Hoist HTTP handlers + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-pages","name":"R2 — Wrap page components in createFileRoute + rename","steps":[{"name":"Structural rewrite + rename","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-special-next-files","name":"R2b — loading / error / not-found / template.tsx (next2tanstack parity)","steps":[{"name":"Map Next special routes to TanStack route modules (template.tsx best-effort)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-dynamic-params","name":"R3 — Rewrite params / searchParams to Route hooks","steps":[{"name":"Replace await params with Route.useParams / Route.useSearch","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-metadata","name":"R7 — Convert `export const metadata` to head() config","steps":[{"name":"Map metadata fields to head() entries","type":"js-ast-grep","language":"tsx"}]},{"id":"annotate-async-pages","name":"R10 — Async loaders (manual follow-up placeholder)","steps":[{"name":"No-op (automatic Route.loader extraction is intentionally skipped)","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-fonts","name":"R9 — Strip next/font and record font names for later steps","steps":[{"name":"Remove imports + className refs + write .codemod/state.json","type":"js-ast-grep","language":"tsx"}]},{"id":"rewrite-server-fns","name":"R8 — Wrap \"use server\" exports in createServerFn","steps":[{"name":"Replace \"use server\" directive","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-link-image","name":"R4 + R5 — Swap next/link and next/image to TanStack / unpic","steps":[{"name":"Replace imports + JSX attributes","type":"js-ast-grep","language":"tsx","semanticAnalysis":"workspace"}]},{"id":"rewrite-next-navigation","name":"R4b — next/navigation hooks → TanStack Router","steps":[{"name":"Migrate usePathname / useSearchParams / useRouter imports","type":"js-ast-grep","language":"tsx"}]},{"id":"patch-globals-css","name":"R12 — Inject @fontsource and @theme blocks","steps":[{"name":"Add font imports to globals.css","type":"js-ast-grep","language":"css"}]},{"id":"patch-package-json","name":"R11 — Update dependencies and scripts","steps":[{"name":"Add TanStack deps, remove Next, add @fontsource-variable/*","type":"js-ast-grep","language":"json"}]},{"id":"finalize-cleanup","name":"Remove codemod sidecar state","steps":[{"name":"Drop .codemod/state.json","type":"js-ast-grep","language":"json"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]}],"distTags":{"latest":"1.3.12"},"latestPackageBehavior":"workflow-only","cachedTestCases":"$19:1:props:state:queries:0:state:data:json:versions:0:version:cachedTestCases"},"meta":{"values":{"versions.0.version.createdAt":["Date"],"versions.0.insightsTemplate.generatedAt":["Date"],"versions.1.version.createdAt":["Date"],"versions.2.version.createdAt":["Date"],"versions.3.version.createdAt":["Date"],"versions.4.version.createdAt":["Date"],"versions.5.version.createdAt":["Date"],"versions.6.version.createdAt":["Date"],"versions.7.version.createdAt":["Date"],"versions.8.version.createdAt":["Date"],"versions.9.version.createdAt":["Date"]},"referentialEqualities":{"cachedTestCases":["versions.0.version.cachedTestCases"]}}},"dataUpdateCount":1,"dataUpdatedAt":1789217453697,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"success","fetchStatus":"idle"},"queryKey":[["registry","getPackage"],{"input":{"name":"nextjs-to-tanstack","scope":"$undefined"},"type":"query"}],"queryHash":"[[\"registry\",\"getPackage\"],{\"input\":{\"name\":\"nextjs-to-tanstack\"},\"type\":\"query\"}]"}]},"children":"$L4a"}]] 1c:null 20:[["$","title","0",{"children":"nextjs-to-tanstack - Codemod Registry"}],["$","meta","1",{"name":"description","content":"Migrate a project from the Next.js App Router to TanStack Start"}],["$","meta","2",{"name":"author","content":"amirabbas08dev@gmail.com"}],["$","meta","3",{"name":"keywords","content":"nextjs-to-tanstack, codemod, code transformation, automated refactoring, package, registry, nextjs, tanstack, migration, app-router, react, transformation"}],["$","meta","4",{"name":"creator","content":"amirabbas08dev@gmail.com"}],["$","meta","5",{"name":"publisher","content":"Codemod"}],["$","meta","6",{"name":"robots","content":"index, follow"}],["$","meta","7",{"name":"googlebot","content":"index, follow, max-video-preview:-1, max-image-preview:large, max-snippet:-1"}],["$","meta","8",{"name":"application-name","content":"Codemod Registry"}],["$","meta","9",{"name":"apple-mobile-web-app-title","content":"Codemod"}],["$","meta","10",{"name":"apple-mobile-web-app-capable","content":"yes"}],["$","meta","11",{"name":"apple-mobile-web-app-status-bar-style","content":"default"}],["$","meta","12",{"name":"format-detection","content":"telephone=no"}],["$","meta","13",{"name":"mobile-web-app-capable","content":"yes"}],["$","meta","14",{"name":"msapplication-config","content":"/browserconfig.xml"}],["$","meta","15",{"name":"msapplication-TileColor","content":"#000000"}],["$","meta","16",{"name":"msapplication-tap-highlight","content":"no"}],["$","meta","17",{"name":"theme-color","content":"#000000"}],["$","meta","18",{"name":"viewport","content":"width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"}],["$","link","19",{"rel":"canonical","href":"https://app.codemod.com/registry/nextjs-to-tanstack"}],["$","meta","20",{"property":"og:title","content":"nextjs-to-tanstack - Codemod Registry"}],["$","meta","21",{"property":"og:description","content":"Migrate a project from the Next.js App Router to TanStack Start"}],["$","meta","22",{"property":"og:url","content":"https://app.codemod.com/registry/nextjs-to-tanstack"}],["$","meta","23",{"property":"og:site_name","content":"Codemod Registry"}],["$","meta","24",{"property":"og:locale","content":"en_US"}],["$","meta","25",{"property":"og:image","content":"https://app.codemod.com/api/og/registry/nextjs-to-tanstack"}],["$","meta","26",{"property":"og:image:width","content":"1200"}],["$","meta","27",{"property":"og:image:height","content":"630"}],["$","meta","28",{"property":"og:image:alt","content":"nextjs-to-tanstack package"}],["$","meta","29",{"property":"og:type","content":"website"}],["$","meta","30",{"name":"twitter:card","content":"summary_large_image"}],["$","meta","31",{"name":"twitter:site","content":"@codemod"}],["$","meta","32",{"name":"twitter:creator","content":"@codemod"}],["$","meta","33",{"name":"twitter:title","content":"nextjs-to-tanstack - Codemod Registry"}],["$","meta","34",{"name":"twitter:description","content":"Migrate a project from the Next.js App Router to TanStack Start"}],["$","meta","35",{"name":"twitter:image","content":"https://app.codemod.com/api/og/registry/nextjs-to-tanstack"}]]