@tdk-landscape/tdk-cli-core 1.3.94 → 1.3.95

package/cli/dist/commands/resource.js

@@ -312,7 +312,7 @@ export const resourceCommand = new Command("resource")
     .description("Create a new resource (service) from scratch, or register an existing one")
     .argument("[name]", "Resource name (kebab-case)")
     .option("-t, --type <type>", "Resource type: backend, frontend, worker, mcp, bring-your-own, sdk", "backend")
-    .option("--framework <id>", "Framework: frontend react (default), vue, svelte, preact, lit, solid, qwik, vanilla; backend hono (default), express, elysia, fastify, nestjs, koa, h3")
+    .option("--framework <id>", "Framework: frontend react (default), vue, svelte, preact, lit, solid, qwik, vanilla, tanstack-router; backend hono (default), express, elysia, fastify, nestjs, koa, h3")
     .option("--language <id>", "Backend language: bun (default), python, go, rust")
     .option("-s, --stack <stack>", "Stack to assign resource to", "default")
     .option("-p, --path <path>", "Custom path for resource directory")

package/cli/dist/frontend-frameworks/registry.js

@@ -5,6 +5,7 @@ import { qwikFrontendProvider } from "./qwik.js";
 import { reactFrontendProvider } from "./react.js";
 import { solidFrontendProvider } from "./solid.js";
 import { svelteFrontendProvider } from "./svelte.js";
+import { tanstackRouterFrontendProvider } from "./tanstack-router.js";
 import { vanillaFrontendProvider } from "./vanilla.js";
 import { vueFrontendProvider } from "./vue.js";
 export const DEFAULT_FRONTEND_FRAMEWORK = "react";
@@ -17,6 +18,7 @@ export const FRONTEND_FRAMEWORKS = {
     solid: solidFrontendProvider,
     qwik: qwikFrontendProvider,
     vanilla: vanillaFrontendProvider,
+    "tanstack-router": tanstackRouterFrontendProvider,
 };
 export function getFrontendFramework(frameworkId) {
     const id = (frameworkId ?? DEFAULT_FRONTEND_FRAMEWORK).trim().toLowerCase();

package/cli/dist/frontend-frameworks/tanstack-router.js

@@ -0,0 +1,102 @@
+// A client-side Vite SPA using TanStack Router with code-based routes. It shares the React toolchain (same Vite config, JSX
+// setting and entry file), so the generators only learn the id. TanStack Start (SSR) is a different contract: bring your own.
+export const tanstackRouterFrontendProvider = {
+    id: "tanstack-router",
+    label: "TanStack Router + React + Vite",
+    dependencies: {
+        "@tanstack/react-router": "^1.0.0",
+        react: "^19.0.0",
+        "react-dom": "^19.0.0",
+    },
+    devDependencies: {
+        "@types/react": "^19.0.0",
+        "@types/react-dom": "^19.0.0",
+        "@vitejs/plugin-react": "^4.3.4",
+    },
+    compilerOptions: {
+        jsx: "react-jsx",
+    },
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.tsx",
+                content: `import { RouterProvider } from '@tanstack/react-router';
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { router } from './router';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <RouterProvider router={router} />
+  </React.StrictMode>
+);
+`,
+                description: "Generating TanStack Router entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/router.tsx",
+                content: `/// <reference types="vite/client" />
+import { createRootRoute, createRoute, createRouter, Link, Outlet } from '@tanstack/react-router';
+
+const rootRoute = createRootRoute({
+  component: () => (
+    <div style={{ padding: '2rem', fontFamily: 'system-ui' }}>
+      <nav>
+        <Link to="/">Home</Link>
+      </nav>
+      <Outlet />
+    </div>
+  ),
+});
+
+const indexRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: '/',
+  component: () => (
+    <>
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    </>
+  ),
+});
+
+const routeTree = rootRoute.addChildren([indexRoute]);
+
+export const router = createRouter({
+  routeTree,
+  // The app is served under /<name>/ behind Traefik, and Vite exposes that base here.
+  basepath: import.meta.env.BASE_URL,
+});
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: typeof router;
+  }
+}
+`,
+                description: "Generating TanStack Router routes",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=tanstack-router.js.map

package/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tdk-cli-internal",
   "private": true,
-  "version": "1.3.94",
+  "version": "1.3.95",
   "description": "TDK CLI — start services on your laptop.",
   "keywords": [
     "tdk",

package/engine/topologies/tilt/generators/typescript/frontend_tsconfig.star

@@ -77,7 +77,7 @@ def generate_frontend_tsconfig(resource_path, write_fn, internal_deps=None, is_d
                 resource_path
             ))
             print("   Docker build will resolve @{npm_scope}/* from node_modules")
-    if framework not in ['react', 'vue', 'svelte', 'preact', 'lit', 'solid', 'qwik', 'vanilla']:
+    if framework not in ['react', 'vue', 'svelte', 'preact', 'lit', 'solid', 'qwik', 'vanilla', 'tanstack-router']:
         fail("Unknown frontend framework for TypeScript generation: " + str(framework))
 
     compiler_options = {
@@ -99,6 +99,8 @@ def generate_frontend_tsconfig(resource_path, write_fn, internal_deps=None, is_d
     }
     if framework == 'react':
         compiler_options['jsx'] = 'react-jsx'
+    elif framework == 'tanstack-router':
+        compiler_options['jsx'] = 'react-jsx'
     elif framework == 'preact':
         compiler_options['jsx'] = 'react-jsx'
         compiler_options['jsxImportSource'] = 'preact'

package/engine/topologies/tilt/generators/vite/frontend.star

@@ -68,6 +68,11 @@ _FRAMEWORK_TEMPLATES = {
         'dev': VANILLA_VITE_FRONTEND,
         'build': VANILLA_VITE_FRONTEND_BUILD,
     },
+    # A React SPA with TanStack Router: same plugin, same config, only the app code differs.
+    'tanstack-router': {
+        'dev': REACT_VITE_FRONTEND,
+        'build': REACT_VITE_FRONTEND_BUILD,
+    },
 }
 
 def _normalize_vite_base_path(base_path):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.94",
+  "version": "1.3.95",
   "description": "TDK CLI — start services on your laptop.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {