@@ -0,0 +1,5 @@
+---
+"@agent-native/core": patch
+---
+
+Fix Vite dev SSR for standalone apps using `file:@agent-native/core` by aliasing monorepo core source and deduping `react-router`. Add a Playwright dev smoke test that catches HydratedRouter/Meta render failures after auto-login.
@@ -187,21 +187,13 @@ jobs:
       # cache hit); no separate `pnpm build` step needed.
       - run: pnpm install --frozen-lockfile
 
-      - name: Scaffold standalone app (starter) and verify pnpm install
-        run: |
-          cd "$(mktemp -d)"
-          node "$GITHUB_WORKSPACE/packages/core/dist/cli/index.js" create test-standalone --template starter
-          cd test-standalone
-          # Fail fast if any workspace: or catalog: refs leaked
-          if grep -r '"workspace:' package.json; then
-            echo "::error::workspace:* ref found in standalone scaffold"
-            exit 1
-          fi
-          if grep -r '"catalog:' package.json; then
-            echo "::error::catalog: ref found in standalone scaffold"
-            exit 1
-          fi
-          pnpm install
+      - name: Install Playwright Chromium for dev smoke
+        run: pnpm exec playwright install chromium
+
+      - name: Standalone starter dev smoke (auto-login + SSR render)
+        # Catches Vite dev SSR failures (e.g. Meta outside HydratedRouter) that
+        # production build alone does not surface. Also scaffolds + pnpm install.
+        run: pnpm qa:standalone-starter-dev
 
       - name: Scaffold workspace (starter + calendar + dispatch) and verify pnpm install + build
         # Dispatch is in the combo because it exercises the
 
@@ -26,6 +26,7 @@
     "test": "pnpm -r --workspace-concurrency=4 test",
     "test:brain-evals": "pnpm --filter brain eval:ci",
     "qa:cli": "tsx scripts/qa-cli-smoke.ts",
+    "qa:standalone-starter-dev": "tsx scripts/qa-standalone-starter-dev-smoke.ts",
     "qa:composer-geometry": "tsx scripts/qa-composer-geometry-smoke.ts",
     "qa:dispatch-workspace-resources": "tsx scripts/qa-dispatch-workspace-resources-smoke.ts",
     "qa:template-routes": "tsx scripts/qa-template-route-matrix.ts",
 
@@ -1,5 +1,11 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
+  _findCorePackageRoot,
+  _getClientDedupe,
   defineConfig,
   isFrameworkDevPath,
   stripMountedDevApiPath,
@@ -561,3 +567,38 @@ describe("Vite CSS build defaults", () => {
     });
   });
 });
+
+describe("local-core dev aliases and router dedupe", () => {
+  it("dedupes react-router when the app depends on react-router", () => {
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "an-vite-dedupe-"));
+    fs.writeFileSync(
+      path.join(tmpDir, "package.json"),
+      JSON.stringify({
+        dependencies: { "react-router": "^7.16.0" },
+      }),
+    );
+
+    const dedupe = _getClientDedupe(tmpDir);
+    expect(dedupe).toContain("react-router");
+    expect(dedupe).toContain("react-router/dom");
+
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it("resolves file:@agent-native/core to a package root with src/index.ts", () => {
+    const coreRoot = path.resolve(import.meta.dirname, "../..");
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "an-vite-core-root-"));
+    fs.writeFileSync(
+      path.join(tmpDir, "package.json"),
+      JSON.stringify({
+        dependencies: {
+          "@agent-native/core": pathToFileURL(coreRoot).href,
+        },
+      }),
+    );
+
+    expect(_findCorePackageRoot(tmpDir)).toBe(coreRoot);
+
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+});
@@ -137,7 +137,16 @@ function hasDep(pkg: string, cwd: string): boolean {
  */
 function getClientDedupe(cwd: string): string[] {
   // Always dedupe React internals (sub-path exports aren't in peerDeps)
-  const always = new Set(["react", "react-dom", "react-dom/client"]);
+  const always = new Set([
+    "react",
+    "react-dom",
+    "react-dom/client",
+    // Framework routers must share one react-router instance so
+    // FrameworkContext (Meta/Links/Scripts) matches ServerRouter/HydratedRouter.
+    ...(hasDep("react-router", cwd)
+      ? ["react-router", "react-router/dom"]
+      : []),
+  ]);
 
   // Server-only packages that never run in the browser — no point deduping.
   const serverOnly = new Set([
@@ -199,19 +208,47 @@ function getClientDedupe(cwd: string): string[] {
  * the alias is active — otherwise the prebundle is built from a snapshot
  * of dist/ at startup and never picks up new exports).
  */
-function findCoreSrcDir(cwd: string): string | null {
+function findCorePackageRoot(cwd: string): string | null {
+  try {
+    const pkg = JSON.parse(
+      fs.readFileSync(path.join(cwd, "package.json"), "utf-8"),
+    ) as {
+      dependencies?: Record<string, string>;
+      devDependencies?: Record<string, string>;
+    };
+    const spec =
+      pkg.dependencies?.["@agent-native/core"] ??
+      pkg.devDependencies?.["@agent-native/core"];
+    if (typeof spec === "string" && spec.startsWith("file:")) {
+      const rooted = fileURLToPath(spec);
+      if (fs.existsSync(path.join(rooted, "src/index.ts"))) return rooted;
+    }
+  } catch {
+    // package.json missing or unreadable — fall through to path heuristics.
+  }
+
   const candidates = [
     path.resolve(cwd, "../../packages/core"), // templates/<name>/
     path.resolve(cwd, "../core"), // packages/<name>/
+    path.resolve(cwd, "node_modules/@agent-native/core"),
   ];
   for (const candidate of candidates) {
-    if (fs.existsSync(path.join(candidate, "src/index.ts"))) {
-      return path.join(candidate, "src");
+    try {
+      if (!fs.existsSync(candidate)) continue;
+      const root = fs.realpathSync(candidate);
+      if (fs.existsSync(path.join(root, "src/index.ts"))) return root;
+    } catch {
+      continue;
     }
   }
   return null;
 }
 
+function findCoreSrcDir(cwd: string): string | null {
+  const root = findCorePackageRoot(cwd);
+  return root ? path.join(root, "src") : null;
+}
+
 /**
  * Every `@agent-native/core` subpath that gets a source alias. Must stay in
  * sync with `getCoreSourceAliases`. Used by `getDefaultOptimizeDeps` to skip
@@ -337,6 +374,12 @@ function getDefaultOptimizeDeps(cwd: string): string[] {
     { specifier: "h3" },
     { specifier: "next-themes" },
     { specifier: "react-hook-form" },
+    ...(hasDep("react-router", cwd)
+      ? [
+          { specifier: "react-router" },
+          { specifier: "react-router/dom", packageName: "react-router" },
+        ]
+      : []),
     { specifier: "sonner" },
     { specifier: "tailwind-merge" },
     { specifier: "zod" },
@@ -1585,3 +1628,8 @@ export function defineConfig(options: ClientConfigOptions = {}): UserConfig {
     },
   };
 }
+
+export {
+  getClientDedupe as _getClientDedupe,
+  findCorePackageRoot as _findCorePackageRoot,
+};
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"@agent-native/core": patch
 +---
++
 +Fix Vite dev SSR for standalone apps using `file:@agent-native/core` by aliasing monorepo core source and deduping `react-router`. Add a Playwright dev smoke test that catches HydratedRouter/Meta render failures after auto-login.