+ scaffolding live
+
+ Agent Orchestrator web UI — phase 0 foundation. No components yet.
+
+
+ );
+}
diff --git a/frontend/apps/web/src/__tests__/router.test.ts b/frontend/apps/web/src/__tests__/router.test.ts
new file mode 100644
index 00000000..95a69faf
--- /dev/null
+++ b/frontend/apps/web/src/__tests__/router.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+
+import { router } from "../router";
+
+// Phase 0 smoke test: the toolchain (Vite + Vitest + TanStack Router) is wired
+// and the code-based route tree constructs without error. Behavioral UI tests
+// arrive with the first real components.
+describe("ao-web scaffolding", () => {
+ it("constructs the TanStack Router instance", () => {
+ expect(router).toBeDefined();
+ expect(router.routeTree).toBeDefined();
+ });
+
+ it("registers the index route on the tree", () => {
+ expect(router.routeTree.children).toBeDefined();
+ });
+});
diff --git a/frontend/apps/web/src/index.css b/frontend/apps/web/src/index.css
new file mode 100644
index 00000000..f1d8c73c
--- /dev/null
+++ b/frontend/apps/web/src/index.css
@@ -0,0 +1 @@
+@import "tailwindcss";
diff --git a/frontend/apps/web/src/main.tsx b/frontend/apps/web/src/main.tsx
new file mode 100644
index 00000000..1dd80645
--- /dev/null
+++ b/frontend/apps/web/src/main.tsx
@@ -0,0 +1,24 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { RouterProvider } from "@tanstack/react-router";
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+
+import { router } from "./router";
+import "./index.css";
+
+// Single shared QueryClient for the SPA. Default options are intentionally bare
+// for phase 0; cache/retry policy lands with the typed API client.
+const queryClient = new QueryClient();
+
+const rootElement = document.getElementById("root");
+if (!rootElement) {
+ throw new Error("ao-web: #root element not found in index.html");
+}
+
+createRoot(rootElement).render(
+