diff --git a/ecosystem-explorer/src/App.test.tsx b/ecosystem-explorer/src/App.test.tsx
index 37cb15c75..7903eb471 100644
--- a/ecosystem-explorer/src/App.test.tsx
+++ b/ecosystem-explorer/src/App.test.tsx
@@ -14,14 +14,39 @@
  * limitations under the License.
  */
 import { render, screen } from "@testing-library/react";
-import { describe, it, expect } from "vitest";
+import { describe, it, expect, afterEach, vi } from "vitest";
 import App from "./App";
+import { ThemeProvider } from "./theme-context";
 
 describe("App", () => {
-  it("renders the page title", async () => {
-    render(<App />);
+  afterEach(() => {
+    vi.unstubAllEnvs();
+  });
+
+  it("renders the legacy app when V1_REDESIGN is disabled", async () => {
+    vi.stubEnv("VITE_FEATURE_FLAG_V1_REDESIGN", "");
+
+    render(
+      <ThemeProvider>
+        <App />
+      </ThemeProvider>
+    );
+
     const heading = await screen.findByRole("heading", { level: 1 });
     expect(heading).toHaveTextContent("OpenTelemetry");
     expect(heading).toHaveTextContent("Ecosystem Explorer");
   });
+
+  it("renders the v1 app when V1_REDESIGN is enabled", async () => {
+    vi.stubEnv("VITE_FEATURE_FLAG_V1_REDESIGN", "true");
+
+    const { container } = render(
+      <ThemeProvider>
+        <App />
+      </ThemeProvider>
+    );
+
+    expect(await screen.findByLabelText("OpenTelemetry")).toBeInTheDocument();
+    expect(container.querySelector(".v1-app")).not.toBeNull();
+  });
 });
diff --git a/ecosystem-explorer/src/App.tsx b/ecosystem-explorer/src/App.tsx
index a1f65485e..47e255054 100644
--- a/ecosystem-explorer/src/App.tsx
+++ b/ecosystem-explorer/src/App.tsx
@@ -13,121 +13,17 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { lazy, Suspense } from "react";
-import { BrowserRouter, Routes, Route } from "react-router-dom";
-import { Header } from "@/components/layout/header";
-import { Footer } from "@/components/layout/footer";
+import { BrowserRouter } from "react-router-dom";
+import { LegacyApp } from "@/LegacyApp";
+import { V1App } from "@/v1";
 import { isEnabled } from "@/lib/feature-flags";
-import { ErrorBoundary } from "@/components/ui/error-boundary";
-
-const HomePage = lazy(() =>
-  import("@/features/home/home-page").then((m) => ({ default: m.HomePage }))
-);
-const JavaAgentPage = lazy(() =>
-  import("@/features/java-agent/java-agent-page").then((m) => ({ default: m.JavaAgentPage }))
-);
-const CollectorPage = lazy(() =>
-  import("@/features/collector/collector-page").then((m) => ({ default: m.CollectorPage }))
-);
-const CollectorDetailPage = lazy(() =>
-  import("@/features/collector/collector-detail-page").then((m) => ({
-    default: m.CollectorDetailPage,
-  }))
-);
-const NotFoundPage = lazy(() =>
-  import("@/features/not-found/not-found-page").then((m) => ({ default: m.NotFoundPage }))
-);
-const JavaInstrumentationListPage = lazy(() =>
-  import("@/features/java-agent/java-instrumentation-list-page").then((m) => ({
-    default: m.JavaInstrumentationListPage,
-  }))
-);
-const JavaConfigurationListPage = lazy(() =>
-  import("@/features/java-agent/java-configuration-list-page").then((m) => ({
-    default: m.JavaConfigurationListPage,
-  }))
-);
-const JavaReleaseComparisonPage = lazy(() =>
-  import("@/features/java-agent/java-release-comparison-page").then((m) => ({
-    default: m.JavaReleaseComparisonPage,
-  }))
-);
-const InstrumentationDetailPage = lazy(() =>
-  import("@/features/java-agent/instrumentation-detail-page").then((m) => ({
-    default: m.InstrumentationDetailPage,
-  }))
-);
-const ConfigurationBuilderPage = lazy(() =>
-  import("@/features/java-agent/configuration/configuration-builder-page").then((m) => ({
-    default: m.ConfigurationBuilderPage,
-  }))
-);
-const AboutPage = lazy(() =>
-  import("@/features/about/about-page").then((m) => ({ default: m.AboutPage }))
-);
 
+/*
+ * Single V1_REDESIGN boundary read. See
+ * `projects/84-ui-ux-design/v1-routing-pivot.md` for the routing pivot context.
+ * Both sub-apps share canonical paths under a single <BrowserRouter>; per-deploy
+ * bundle selection is driven by netlify.toml's `feat/84-*` branch pattern.
+ */
 export default function App() {
-  return (
-    <BrowserRouter>
-      <div className="bg-background flex min-h-screen flex-col">
-        <Header />
-        <main className="flex-1 pt-16">
-          <ErrorBoundary>
-            <Suspense
-              fallback={
-                <div
-                  className="flex min-h-[400px] items-center justify-center"
-                  role="status"
-                  aria-live="polite"
-                >
-                  <div className="text-muted-foreground text-sm font-medium">Loading…</div>
-                </div>
-              }
-            >
-              <Routes>
-                <Route path="/" element={<HomePage />} />
-                <Route path="/java-agent" element={<JavaAgentPage />} />
-                <Route
-                  path="/java-agent/instrumentation"
-                  element={<JavaInstrumentationListPage />}
-                />
-                <Route
-                  path="/java-agent/instrumentation/:version"
-                  element={<JavaInstrumentationListPage />}
-                />
-                <Route
-                  path="/java-agent/instrumentation/:version/:name"
-                  element={<InstrumentationDetailPage />}
-                />
-                <Route path="/java-agent/configuration" element={<JavaConfigurationListPage />} />
-                {isEnabled("JAVA_RELEASE_COMPARISON") && (
-                  <Route path="/java-agent/releases" element={<JavaReleaseComparisonPage />} />
-                )}
-                {isEnabled("JAVA_CONFIG_BUILDER") && (
-                  <Route
-                    path="/java-agent/configuration/builder"
-                    element={<ConfigurationBuilderPage />}
-                  />
-                )}
-                <Route path="/collector" element={<CollectorPage />} />
-                {isEnabled("COLLECTOR_PAGE") && (
-                  <>
-                    <Route path="/collector/components" element={<CollectorPage />} />
-                    <Route path="/collector/components/:version" element={<CollectorPage />} />
-                    <Route
-                      path="/collector/components/:version/:id"
-                      element={<CollectorDetailPage />}
-                    />
-                  </>
-                )}
-                <Route path="/about" element={<AboutPage />} />
-                <Route path="*" element={<NotFoundPage />} />
-              </Routes>
-            </Suspense>
-          </ErrorBoundary>
-        </main>
-        <Footer />
-      </div>
-    </BrowserRouter>
-  );
+  return <BrowserRouter>{isEnabled("V1_REDESIGN") ? <V1App /> : <LegacyApp />}</BrowserRouter>;
 }
diff --git a/ecosystem-explorer/src/LegacyApp.tsx b/ecosystem-explorer/src/LegacyApp.tsx
new file mode 100644
index 000000000..20d8130bb
--- /dev/null
+++ b/ecosystem-explorer/src/LegacyApp.tsx
@@ -0,0 +1,138 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { lazy, Suspense } from "react";
+import { Routes, Route } from "react-router-dom";
+import { Header } from "@/components/layout/header";
+import { Footer } from "@/components/layout/footer";
+import { isEnabled } from "@/lib/feature-flags";
+import { ErrorBoundary } from "@/components/ui/error-boundary";
+
+const HomePage = lazy(() =>
+  import("@/features/home/home-page").then((m) => ({ default: m.HomePage }))
+);
+const JavaAgentPage = lazy(() =>
+  import("@/features/java-agent/java-agent-page").then((m) => ({ default: m.JavaAgentPage }))
+);
+const CollectorPage = lazy(() =>
+  import("@/features/collector/collector-page").then((m) => ({ default: m.CollectorPage }))
+);
+const CollectorDetailPage = lazy(() =>
+  import("@/features/collector/collector-detail-page").then((m) => ({
+    default: m.CollectorDetailPage,
+  }))
+);
+const NotFoundPage = lazy(() =>
+  import("@/features/not-found/not-found-page").then((m) => ({ default: m.NotFoundPage }))
+);
+const JavaInstrumentationListPage = lazy(() =>
+  import("@/features/java-agent/java-instrumentation-list-page").then((m) => ({
+    default: m.JavaInstrumentationListPage,
+  }))
+);
+const JavaConfigurationListPage = lazy(() =>
+  import("@/features/java-agent/java-configuration-list-page").then((m) => ({
+    default: m.JavaConfigurationListPage,
+  }))
+);
+const JavaReleaseComparisonPage = lazy(() =>
+  import("@/features/java-agent/java-release-comparison-page").then((m) => ({
+    default: m.JavaReleaseComparisonPage,
+  }))
+);
+const InstrumentationDetailPage = lazy(() =>
+  import("@/features/java-agent/instrumentation-detail-page").then((m) => ({
+    default: m.InstrumentationDetailPage,
+  }))
+);
+const ConfigurationBuilderPage = lazy(() =>
+  import("@/features/java-agent/configuration/configuration-builder-page").then((m) => ({
+    default: m.ConfigurationBuilderPage,
+  }))
+);
+const AboutPage = lazy(() =>
+  import("@/features/about/about-page").then((m) => ({ default: m.AboutPage }))
+);
+
+/*
+ * Pre-pivot router subtree, reached when `isEnabled("V1_REDESIGN")` is false in
+ * `src/App.tsx`. The route table below MUST stay in sync with the table in
+ * `src/v1/V1App.tsx` until the cleanup deletes this file. Any new global
+ * route added here must also be added there, otherwise it's reachable only in
+ * legacy builds and 404s on `feat/84-*` preview deploys.
+ *
+ * When the cleanup PR removes this file, the route-sync warning becomes moot:
+ * v1's table becomes the only table.
+ */
+export function LegacyApp() {
+  return (
+    <div className="bg-background flex min-h-screen flex-col">
+      <Header />
+      <main className="flex-1 pt-16">
+        <ErrorBoundary>
+          <Suspense
+            fallback={
+              <div
+                className="flex min-h-[400px] items-center justify-center"
+                role="status"
+                aria-live="polite"
+              >
+                <div className="text-muted-foreground text-sm font-medium">Loading…</div>
+              </div>
+            }
+          >
+            <Routes>
+              <Route path="/" element={<HomePage />} />
+              <Route path="/java-agent" element={<JavaAgentPage />} />
+              <Route path="/java-agent/instrumentation" element={<JavaInstrumentationListPage />} />
+              <Route
+                path="/java-agent/instrumentation/:version"
+                element={<JavaInstrumentationListPage />}
+              />
+              <Route
+                path="/java-agent/instrumentation/:version/:name"
+                element={<InstrumentationDetailPage />}
+              />
+              <Route path="/java-agent/configuration" element={<JavaConfigurationListPage />} />
+              {isEnabled("JAVA_RELEASE_COMPARISON") && (
+                <Route path="/java-agent/releases" element={<JavaReleaseComparisonPage />} />
+              )}
+              {isEnabled("JAVA_CONFIG_BUILDER") && (
+                <Route
+                  path="/java-agent/configuration/builder"
+                  element={<ConfigurationBuilderPage />}
+                />
+              )}
+              <Route path="/collector" element={<CollectorPage />} />
+              {isEnabled("COLLECTOR_PAGE") && (
+                <>
+                  <Route path="/collector/components" element={<CollectorPage />} />
+                  <Route path="/collector/components/:version" element={<CollectorPage />} />
+                  <Route
+                    path="/collector/components/:version/:id"
+                    element={<CollectorDetailPage />}
+                  />
+                </>
+              )}
+              <Route path="/about" element={<AboutPage />} />
+              <Route path="*" element={<NotFoundPage />} />
+            </Routes>
+          </Suspense>
+        </ErrorBoundary>
+      </main>
+      <Footer />
+    </div>
+  );
+}
diff --git a/ecosystem-explorer/src/main.tsx b/ecosystem-explorer/src/main.tsx
index 755fe45d7..b0ab67403 100644
--- a/ecosystem-explorer/src/main.tsx
+++ b/ecosystem-explorer/src/main.tsx
@@ -19,6 +19,24 @@ import { createRoot } from "react-dom/client";
 import "./styles/index.css";
 import App from "./App.tsx";
 import { ThemeProvider } from "./theme-context";
+import { isEnabled } from "./lib/feature-flags";
+
+/*
+ * Apply `.v1-app` to <html> before React mounts so the body background uses
+ * v1 surface tokens (`src/v1/styles/tokens.css`) from the first paint. Without
+ * this, body would briefly render against the legacy navy palette during the
+ * React mount window before `<V1App />`'s wrapper div applies its override.
+ *
+ * This is the only flag read outside `src/App.tsx`'s boundary. The
+ * 2026-05-12 pivot collapsed per-component flag sprawl into a single
+ * App.tsx boundary read; this narrow early-paint marker is the carve-out
+ * needed to keep body bg painted correctly without a flash. CSS variables
+ * declared on `<html>` cascade to `<body>` via `body { background-color:
+ * hsl(var(--background-hsl)) }` in `src/styles/base.css`.
+ */
+if (isEnabled("V1_REDESIGN")) {
+  document.documentElement.classList.add("v1-app");
+}
 
 createRoot(document.getElementById("root")!).render(
   <StrictMode>
diff --git a/ecosystem-explorer/src/styles/index.css b/ecosystem-explorer/src/styles/index.css
index f6d538c13..6e871d6b8 100644
--- a/ecosystem-explorer/src/styles/index.css
+++ b/ecosystem-explorer/src/styles/index.css
@@ -20,8 +20,10 @@
  * - tokens.css        — design-token CSS custom properties (per-theme HSL triplets)
  * - base.css          — global element resets
  * - syntax.css        — YAML / config syntax-highlight token classes
- * - navbar.css        — v1 navbar (`.td-navbar`) — mirrors opentelemetry.io
- * - theme-toggle.css  — v1 theme toggle dropdown — mirrors opentelemetry.io
+ *
+ * V1 chrome styles (`navbar.css`, `theme-toggle.css`, v1 surface-token overrides)
+ * live under `src/v1/styles/` and are imported by `<V1App />` so they only
+ * affect the v1 subtree. See `projects/84-ui-ux-design/v1-routing-pivot.md`.
  *
  * Tailwind v4 bundles @import rules via Lightning CSS at build time, so each
  * partial is inlined into the final stylesheet — no extra network requests.
@@ -31,8 +33,6 @@
 @import "./tokens.css";
 @import "./base.css";
 @import "./syntax.css";
-@import "./navbar.css";
-@import "./theme-toggle.css";
 
 /**
  * Tailwind theme — maps --*-hsl triplets to hsl() utility classes.
diff --git a/ecosystem-explorer/src/styles/tokens.css b/ecosystem-explorer/src/styles/tokens.css
index 63a89ca25..31be937de 100644
--- a/ecosystem-explorer/src/styles/tokens.css
+++ b/ecosystem-explorer/src/styles/tokens.css
@@ -103,26 +103,4 @@
     --syntax-keyword-hsl: 265 70% 78%;
     --syntax-punct-hsl: 220 22% 55%;
   }
-
-  /*
-   * V1_REDESIGN page-surface overrides — gated on `<html data-v1-redesign>`
-   * which `main.tsx` sets at bundle load when the feature flag is on. Aligns
-   * the explorer's page bg/fg with opentelemetry.io's Bootstrap defaults so
-   * the new chrome doesn't sit on a mismatched navy backdrop. Other surface
-   * tokens (card, muted, border) stay on the explorer's palette for now;
-   * those move when their pages get redesigned.
-   *   Dark:  --bs-body-bg = #212529 (gray-900) / --bs-body-color = #dee2e6
-   *   Light: --bs-body-bg = #fff             / --bs-body-color = #212529
-   * Light values are already this in the explorer, so we override dark only.
-   */
-  [data-v1-redesign="true"],
-  [data-v1-redesign="true"][data-theme="dark"] {
-    --background-hsl: 210 11% 15%; /* #212529 */
-    --foreground-hsl: 210 11% 88%; /* #dee2e6 */
-  }
-
-  [data-v1-redesign="true"][data-theme="light"] {
-    --background-hsl: 0 0% 100%;
-    --foreground-hsl: 210 11% 15%;
-  }
 }
diff --git a/ecosystem-explorer/src/v1/V1App.test.tsx b/ecosystem-explorer/src/v1/V1App.test.tsx
new file mode 100644
index 000000000..3678db907
--- /dev/null
+++ b/ecosystem-explorer/src/v1/V1App.test.tsx
@@ -0,0 +1,47 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { render, screen } from "@testing-library/react";
+import { MemoryRouter } from "react-router-dom";
+import { describe, it, expect } from "vitest";
+import { V1App } from "./V1App";
+import { ThemeProvider } from "@/theme-context";
+
+describe("V1App", () => {
+  it("renders the v1 navbar", async () => {
+    render(
+      <ThemeProvider>
+        <MemoryRouter initialEntries={["/"]}>
+          <V1App />
+        </MemoryRouter>
+      </ThemeProvider>
+    );
+
+    expect(await screen.findByLabelText("OpenTelemetry")).toBeInTheDocument();
+    expect(screen.getByRole("navigation", { name: /primary/i })).toBeInTheDocument();
+  });
+
+  it("wraps content in a .v1-app scoping container", () => {
+    const { container } = render(
+      <ThemeProvider>
+        <MemoryRouter initialEntries={["/"]}>
+          <V1App />
+        </MemoryRouter>
+      </ThemeProvider>
+    );
+
+    expect(container.querySelector(".v1-app")).not.toBeNull();
+  });
+});
diff --git a/ecosystem-explorer/src/v1/V1App.tsx b/ecosystem-explorer/src/v1/V1App.tsx
new file mode 100644
index 000000000..f206c4785
--- /dev/null
+++ b/ecosystem-explorer/src/v1/V1App.tsx
@@ -0,0 +1,146 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { lazy, Suspense } from "react";
+import { Routes, Route } from "react-router-dom";
+import { Footer } from "@/components/layout/footer";
+import { ErrorBoundary } from "@/components/ui/error-boundary";
+import { isEnabled } from "@/lib/feature-flags";
+import { NavBar } from "@/v1/components/layout/nav-bar";
+import "@/v1/styles/index.css";
+
+/*
+ * V1 sub-app entry. Reached via the V1_REDESIGN boundary read in `src/App.tsx`.
+ * Owns its own `<Routes>` and v1 chrome. The legacy `<Footer />` is reused as a
+ * temporary placeholder until PR 6 ships `<FooterV1 />` + `<CncfCallout />`.
+ *
+ * The `.v1-app` wrapper class scopes v1-specific surface-token overrides defined
+ * in `src/v1/styles/tokens.css` so they don't leak into the legacy app.
+ *
+ * Route paths mirror `<LegacyApp />` verbatim — both sub-apps share the
+ * canonical path space, and the boundary read decides which is reachable per
+ * deploy. Phase 2-5 PRs each swap one route's component to its v1 version.
+ *
+ * Route-sync: the route table below mirrors `src/LegacyApp.tsx`. Any new global
+ * route added here must also be added there until LegacyApp.tsx is deleted,
+ * otherwise the route is reachable only in v1 builds and 404s in legacy.
+ */
+
+const HomePage = lazy(() =>
+  import("@/features/home/home-page").then((m) => ({ default: m.HomePage }))
+);
+const JavaAgentPage = lazy(() =>
+  import("@/features/java-agent/java-agent-page").then((m) => ({ default: m.JavaAgentPage }))
+);
+const CollectorPage = lazy(() =>
+  import("@/features/collector/collector-page").then((m) => ({ default: m.CollectorPage }))
+);
+const CollectorDetailPage = lazy(() =>
+  import("@/features/collector/collector-detail-page").then((m) => ({
+    default: m.CollectorDetailPage,
+  }))
+);
+const NotFoundPage = lazy(() =>
+  import("@/features/not-found/not-found-page").then((m) => ({ default: m.NotFoundPage }))
+);
+const JavaInstrumentationListPage = lazy(() =>
+  import("@/features/java-agent/java-instrumentation-list-page").then((m) => ({
+    default: m.JavaInstrumentationListPage,
+  }))
+);
+const JavaConfigurationListPage = lazy(() =>
+  import("@/features/java-agent/java-configuration-list-page").then((m) => ({
+    default: m.JavaConfigurationListPage,
+  }))
+);
+const JavaReleaseComparisonPage = lazy(() =>
+  import("@/features/java-agent/java-release-comparison-page").then((m) => ({
+    default: m.JavaReleaseComparisonPage,
+  }))
+);
+const InstrumentationDetailPage = lazy(() =>
+  import("@/features/java-agent/instrumentation-detail-page").then((m) => ({
+    default: m.InstrumentationDetailPage,
+  }))
+);
+const ConfigurationBuilderPage = lazy(() =>
+  import("@/features/java-agent/configuration/configuration-builder-page").then((m) => ({
+    default: m.ConfigurationBuilderPage,
+  }))
+);
+const AboutPage = lazy(() =>
+  import("@/features/about/about-page").then((m) => ({ default: m.AboutPage }))
+);
+
+export function V1App() {
+  return (
+    <div className="v1-app bg-background flex min-h-screen flex-col">
+      <NavBar />
+      <main className="flex-1 pt-16">
+        <ErrorBoundary>
+          <Suspense
+            fallback={
+              <div
+                className="flex min-h-[400px] items-center justify-center"
+                role="status"
+                aria-live="polite"
+              >
+                <div className="text-muted-foreground text-sm font-medium">Loading…</div>
+              </div>
+            }
+          >
+            <Routes>
+              <Route path="/" element={<HomePage />} />
+              <Route path="/java-agent" element={<JavaAgentPage />} />
+              <Route path="/java-agent/instrumentation" element={<JavaInstrumentationListPage />} />
+              <Route
+                path="/java-agent/instrumentation/:version"
+                element={<JavaInstrumentationListPage />}
+              />
+              <Route
+                path="/java-agent/instrumentation/:version/:name"
+                element={<InstrumentationDetailPage />}
+              />
+              <Route path="/java-agent/configuration" element={<JavaConfigurationListPage />} />
+              {isEnabled("JAVA_RELEASE_COMPARISON") && (
+                <Route path="/java-agent/releases" element={<JavaReleaseComparisonPage />} />
+              )}
+              {isEnabled("JAVA_CONFIG_BUILDER") && (
+                <Route
+                  path="/java-agent/configuration/builder"
+                  element={<ConfigurationBuilderPage />}
+                />
+              )}
+              <Route path="/collector" element={<CollectorPage />} />
+              {isEnabled("COLLECTOR_PAGE") && (
+                <>
+                  <Route path="/collector/components" element={<CollectorPage />} />
+                  <Route path="/collector/components/:version" element={<CollectorPage />} />
+                  <Route
+                    path="/collector/components/:version/:id"
+                    element={<CollectorDetailPage />}
+                  />
+                </>
+              )}
+              <Route path="/about" element={<AboutPage />} />
+              <Route path="*" element={<NotFoundPage />} />
+            </Routes>
+          </Suspense>
+        </ErrorBoundary>
+      </main>
+      <Footer />
+    </div>
+  );
+}
diff --git a/ecosystem-explorer/src/components/icons/bs-icon-circle-half.tsx b/ecosystem-explorer/src/v1/components/icons/bs-icon-circle-half.tsx
similarity index 100%
rename from ecosystem-explorer/src/components/icons/bs-icon-circle-half.tsx
rename to ecosystem-explorer/src/v1/components/icons/bs-icon-circle-half.tsx
diff --git a/ecosystem-explorer/src/components/icons/bs-icon-moon-stars-fill.tsx b/ecosystem-explorer/src/v1/components/icons/bs-icon-moon-stars-fill.tsx
similarity index 100%
rename from ecosystem-explorer/src/components/icons/bs-icon-moon-stars-fill.tsx
rename to ecosystem-explorer/src/v1/components/icons/bs-icon-moon-stars-fill.tsx
diff --git a/ecosystem-explorer/src/components/icons/bs-icon-sun-fill.tsx b/ecosystem-explorer/src/v1/components/icons/bs-icon-sun-fill.tsx
similarity index 100%
rename from ecosystem-explorer/src/components/icons/bs-icon-sun-fill.tsx
rename to ecosystem-explorer/src/v1/components/icons/bs-icon-sun-fill.tsx
diff --git a/ecosystem-explorer/src/components/icons/opentelemetry-wordmark.tsx b/ecosystem-explorer/src/v1/components/icons/opentelemetry-wordmark.tsx
similarity index 100%
rename from ecosystem-explorer/src/components/icons/opentelemetry-wordmark.tsx
rename to ecosystem-explorer/src/v1/components/icons/opentelemetry-wordmark.tsx
diff --git a/ecosystem-explorer/src/components/layout/nav-bar.test.tsx b/ecosystem-explorer/src/v1/components/layout/nav-bar.test.tsx
similarity index 100%
rename from ecosystem-explorer/src/components/layout/nav-bar.test.tsx
rename to ecosystem-explorer/src/v1/components/layout/nav-bar.test.tsx
diff --git a/ecosystem-explorer/src/components/layout/nav-bar.tsx b/ecosystem-explorer/src/v1/components/layout/nav-bar.tsx
similarity index 94%
rename from ecosystem-explorer/src/components/layout/nav-bar.tsx
rename to ecosystem-explorer/src/v1/components/layout/nav-bar.tsx
index 6a75b44e7..5bb72f83d 100644
--- a/ecosystem-explorer/src/components/layout/nav-bar.tsx
+++ b/ecosystem-explorer/src/v1/components/layout/nav-bar.tsx
@@ -15,13 +15,13 @@
  */
 import { useEffect, useState } from "react";
 import { Link } from "react-router-dom";
-import { OpenTelemetryWordmark } from "@/components/icons/opentelemetry-wordmark";
-import { ThemeToggle } from "@/components/ui/theme-toggle";
+import { OpenTelemetryWordmark } from "@/v1/components/icons/opentelemetry-wordmark";
+import { ThemeToggle } from "@/v1/components/ui/theme-toggle";
 
 /*
  * Markup mirrors opentelemetry.io's `themes/docsy/layouts/_partials/navbar.html`
  * (logo lockup + nav-scroll wrapper that gets `margin-left: auto` at md+).
- * All visuals live in `src/styles/navbar.css` — Tailwind utilities are
+ * All visuals live in `src/v1/styles/navbar.css` — Tailwind utilities are
  * intentionally avoided here so the chrome stays in sync with the upstream
  * SCSS without rem-scaling guesswork.
  *
diff --git a/ecosystem-explorer/src/components/ui/theme-toggle.test.tsx b/ecosystem-explorer/src/v1/components/ui/theme-toggle.test.tsx
similarity index 100%
rename from ecosystem-explorer/src/components/ui/theme-toggle.test.tsx
rename to ecosystem-explorer/src/v1/components/ui/theme-toggle.test.tsx
diff --git a/ecosystem-explorer/src/components/ui/theme-toggle.tsx b/ecosystem-explorer/src/v1/components/ui/theme-toggle.tsx
similarity index 89%
rename from ecosystem-explorer/src/components/ui/theme-toggle.tsx
rename to ecosystem-explorer/src/v1/components/ui/theme-toggle.tsx
index 48312053f..77a68c38a 100644
--- a/ecosystem-explorer/src/components/ui/theme-toggle.tsx
+++ b/ecosystem-explorer/src/v1/components/ui/theme-toggle.tsx
@@ -15,9 +15,9 @@
  */
 import { type JSX } from "react";
 import * as DropdownMenu from "@radix-ui/react-dropdown-menu";
-import { BsCircleHalf } from "@/components/icons/bs-icon-circle-half";
-import { BsSunFill } from "@/components/icons/bs-icon-sun-fill";
-import { BsMoonStarsFill } from "@/components/icons/bs-icon-moon-stars-fill";
+import { BsCircleHalf } from "@/v1/components/icons/bs-icon-circle-half";
+import { BsSunFill } from "@/v1/components/icons/bs-icon-sun-fill";
+import { BsMoonStarsFill } from "@/v1/components/icons/bs-icon-moon-stars-fill";
 import { type ThemeMode, useTheme } from "@/theme-context";
 
 /*
@@ -27,7 +27,7 @@ import { type ThemeMode, useTheme } from "@/theme-context";
  *   - menu rows are Light / Dark / Auto with Bootstrap-Icons glyphs
  *   - active row is signalled by background colour only (no checkmark) —
  *     upstream renders a `check2` SVG but always `d-none`-hides it.
- * Visuals live in `src/styles/theme-toggle.css`.
+ * Visuals live in `src/v1/styles/theme-toggle.css`.
  */
 
 type Option = {
diff --git a/ecosystem-explorer/src/v1/index.ts b/ecosystem-explorer/src/v1/index.ts
new file mode 100644
index 000000000..33441c03b
--- /dev/null
+++ b/ecosystem-explorer/src/v1/index.ts
@@ -0,0 +1,16 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { V1App } from "./V1App";
diff --git a/ecosystem-explorer/src/v1/styles/index.css b/ecosystem-explorer/src/v1/styles/index.css
new file mode 100644
index 000000000..eb65f3ccf
--- /dev/null
+++ b/ecosystem-explorer/src/v1/styles/index.css
@@ -0,0 +1,30 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * V1 styles entry point — imported by `src/v1/V1App.tsx`.
+ *
+ * - tokens.css       — v1-only surface-token overrides, scoped via `.v1-app`
+ * - navbar.css       — v1 navbar (`.td-navbar`) — mirrors opentelemetry.io
+ * - theme-toggle.css — v1 theme toggle dropdown — mirrors opentelemetry.io
+ *
+ * Navbar and theme-toggle styles use class selectors (`.td-navbar`,
+ * `.td-light-dark-menu__*`) and only match elements rendered by `<V1App />`,
+ * so they're inert in the legacy bundle even when both branches ship.
+ */
+@import "./tokens.css";
+@import "./navbar.css";
+@import "./theme-toggle.css";
diff --git a/ecosystem-explorer/src/styles/navbar.css b/ecosystem-explorer/src/v1/styles/navbar.css
similarity index 100%
rename from ecosystem-explorer/src/styles/navbar.css
rename to ecosystem-explorer/src/v1/styles/navbar.css
diff --git a/ecosystem-explorer/src/styles/theme-toggle.css b/ecosystem-explorer/src/v1/styles/theme-toggle.css
similarity index 100%
rename from ecosystem-explorer/src/styles/theme-toggle.css
rename to ecosystem-explorer/src/v1/styles/theme-toggle.css
diff --git a/ecosystem-explorer/src/v1/styles/tokens.css b/ecosystem-explorer/src/v1/styles/tokens.css
new file mode 100644
index 000000000..2967fec27
--- /dev/null
+++ b/ecosystem-explorer/src/v1/styles/tokens.css
@@ -0,0 +1,51 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * V1 page-surface overrides — declared on `.v1-app` so they cascade only
+ * through v1 chrome. The class is set in two places that both match the same
+ * `.v1-app` rule:
+ *   1. `src/main.tsx` adds it to `<html>` pre-mount so body bg paints
+ *      against v1 surface tokens from the first paint (no flash).
+ *   2. `<V1App />`'s wrapper `<div className="v1-app">` carries it for any
+ *      nested cascade scoping inside the app tree.
+ *
+ * `data-theme` lives on `<html>` (set by ThemeProvider). The light-theme
+ * override needs two selectors:
+ *   - `[data-theme="light"].v1-app`  — matches `<html>` when both attrs are
+ *     on the same element (main.tsx case)
+ *   - `[data-theme="light"] .v1-app` — matches the wrapper `<div>` when it's
+ *     a descendant of light-themed html (still works for nested cascade)
+ *
+ * Aligns v1 page bg/fg with opentelemetry.io's Bootstrap defaults so the new
+ * chrome doesn't sit on a mismatched navy backdrop. Other surface tokens
+ * (card, muted, border) stay on the explorer's palette for now; those move
+ * when their pages get redesigned.
+ *   Dark:  --bs-body-bg = #212529 (gray-900) / --bs-body-color = #dee2e6
+ *   Light: --bs-body-bg = #fff               / --bs-body-color = #212529
+ */
+@layer theme {
+  .v1-app {
+    --background-hsl: 210 11% 15%; /* #212529 */
+    --foreground-hsl: 210 11% 88%; /* #dee2e6 */
+  }
+
+  [data-theme="light"].v1-app,
+  [data-theme="light"] .v1-app {
+    --background-hsl: 0 0% 100%;
+    --foreground-hsl: 210 11% 15%;
+  }
+}
diff --git a/projects/84-ui-ux-design/00-foundation-audit.md b/projects/84-ui-ux-design/00-foundation-audit.md
index 4334ea7e1..ec71e0584 100644
--- a/projects/84-ui-ux-design/00-foundation-audit.md
+++ b/projects/84-ui-ux-design/00-foundation-audit.md
@@ -189,6 +189,14 @@ icons right. Uses Lucide for consistency (avoid adding Font Awesome — see open
 **Concrete delta:** New `<FooterV1 />` (name TBD). Same flag swap pattern as NavBar. Footer test
 (`footer.test.tsx`) gets a sibling test for the new version.
 
+**Pre-PR-6 visual audit:** PR 2b reuses the legacy `<Footer />` inside `<V1App />` as a placeholder.
+The legacy footer's text colors (`text-muted-foreground`, link hovers, copyright) were tuned for the
+legacy navy palette; rendered inside `.v1-app`, body bg shifts to `#212529` (Bootstrap gray-900) but
+card / muted / border tokens still come from the global legacy palette, so contrast may regress.
+Before opening PR 6, capture the rendered contrast on a `feat/84-*` preview deploy and document any
+WCAG AA failures. PR 6's `<FooterV1 />` ships against the v1 surface tokens deliberately, so it
+shouldn't inherit the placeholder's issues, but the baseline gives a concrete target.
+
 ### 6. CncfCallout
 
 **Today:** None.
@@ -300,19 +308,53 @@ const FEATURE_FLAGS = [
 ### Use the flag (App.tsx boundary pattern)
 
 ```tsx
+import { BrowserRouter } from "react-router-dom";
 import { isEnabled } from "@/lib/feature-flags";
-import { LegacyApp } from "@/legacy/LegacyApp"; // or inline in App.tsx
-import { V1App } from "@/v1/V1App";
+import { LegacyApp } from "@/LegacyApp";
+import { V1App } from "@/v1";
 
 export default function App() {
-  return isEnabled("V1_REDESIGN") ? <V1App /> : <LegacyApp />;
+  return <BrowserRouter>{isEnabled("V1_REDESIGN") ? <V1App /> : <LegacyApp />}</BrowserRouter>;
 }
 ```
 
-`<V1App />` lives at `src/v1/V1App.tsx` and owns its own `<BrowserRouter>` (or shared) +
-`<Routes>` + chrome (`<NavBar />`, `<Footer />`, `<CncfCallout />`). `<LegacyApp />` is the
-pre-pivot router subtree (`<Header />` + existing `<Routes>` + `<Footer />`). Each Netlify deploy
-bundles whichever branch is reachable; the unused branch is tree-shaken out.
+A single `<BrowserRouter>` wraps both sub-apps so they share a Router instance and the URL bar
+behaves identically. `<V1App />` lives at `src/v1/V1App.tsx` and owns its own `<Routes>` + chrome
+(`<NavBar />`, `<Footer />` placeholder until PR 6, `<CncfCallout />` in PR 6). `<LegacyApp />`
+lives at `src/LegacyApp.tsx` and is the pre-pivot router subtree (`<Header />` + existing
+`<Routes>` + legacy `<Footer />`).
+
+Both sub-apps mirror the same route list — the v1 route table starts identical to legacy (rendering
+the same lazy-loaded page components) and each Phase 2-5 PR swaps one route's component to its v1
+version. `LegacyApp.tsx`'s table is frozen until PR 8 deletes it.
+
+Per-deploy bundle: both branches ship in both bundles because `isEnabled()` uses computed-key env
+access that Vite's static-replacement pass can't constant-fold. Cost is ~5KB JS + ~11KB CSS of
+unused selectors per build — accepted in exchange for keeping the flag-read convention consistent
+across the codebase. CSS doesn't leak: v1 stylesheets are imported only by `<V1App />` and selectors
+use `.td-navbar`, `.td-light-dark-menu__*`, or `.v1-app` — none of which match elements rendered by
+`<LegacyApp />`.
+
+### CSS scoping
+
+v1 stylesheets live under `src/v1/styles/` (aggregated by `src/v1/styles/index.css`, imported by
+`<V1App />`). Surface-token overrides that the dormant `[data-v1-redesign]` block carried in
+`src/styles/tokens.css` move to `src/v1/styles/tokens.css` and re-scope from
+`[data-v1-redesign="true"][data-theme="X"]` to `.v1-app` (dark default) + a paired
+`[data-theme="light"].v1-app, [data-theme="light"] .v1-app` (light override; same-element +
+descendant selectors so the rule matches whether `.v1-app` sits on `<html>` or on the wrapper div).
+`data-theme` lives on `<html>` (ThemeProvider contract, unchanged).
+
+The `.v1-app` class is applied in **two** places, both intentional:
+
+- **`src/main.tsx`** adds it to `<html>` pre-mount via a single flag read. This is the only flag
+  read outside `src/App.tsx`'s boundary — the carve-out exists so body bg paints against v1 surface
+  tokens from the first paint (CSS variables on `.v1-app` cascade to `<body>` via the
+  `body { background-color: hsl(var(--background-hsl)) }` rule in `src/styles/base.css`). Without
+  it, body would briefly render against legacy navy during the React mount window.
+- **`<V1App />`'s wrapper `<div className="v1-app">`** carries the class for nested cascade scoping
+  inside the app tree. Redundant with the html-level class but harmless — both elements match the
+  same rule and declare the same values.
 
 ### Enable locally
 
diff --git a/projects/84-ui-ux-design/NEXT-STEPS.md b/projects/84-ui-ux-design/NEXT-STEPS.md
index 83740aa72..d27a8f4e3 100644
--- a/projects/84-ui-ux-design/NEXT-STEPS.md
+++ b/projects/84-ui-ux-design/NEXT-STEPS.md
@@ -65,20 +65,13 @@ This is a _living_ document. Update it as decisions land and PRs ship. Cross-ref
 
 In order:
 
-- [ ] Commit and open PR from `feat/84-pr1-theme-system` — code is complete, tests green, typecheck
-      clean. See commit messages in the session log. No visible UI changes; verification via
-      DevTools.
-- [ ] Merge `feat/84-layout-mockups` (planning artifacts) as its own PR so the docs are on `main`.
-      Can happen in parallel with PR 1 review.
-- [ ] Re-scope and open PR from `feat/84-pr2-navbar` (branched off `feat/84-pr1-theme-system`, will
-      be rebased onto `main` once PR 1 merges) — **post-pivot**: docs capture the `V1_REDESIGN`
-      boundary-read pivot; navbar component, theme-toggle rewrite, icons, and CSS ship as
-      **dormant** code (no consumer); `App.tsx` and `main.tsx` flag wiring reverted. Tests green,
-      typecheck clean.
-- [ ] Open PR 2b (`feat/84-pr2b-v1-scaffolding`) — introduce `src/v1/`, write a minimal `<V1App />`
-      mounting the dormant navbar + footer, move v1 chrome from `src/components/layout/` into
-      `src/v1/components/layout/`, and add the single boundary read in `src/App.tsx`. First PR where
-      the redesign is reachable on `feat/84-*` preview deploys.
+- [x] PR 1 (#377), PR 4 (#455), PR 2 (#453) — all merged on `main`.
+- [ ] Open PR 2b (`feat/84-pr2b-v1-scaffolding`) — branch off `main`, introduce `src/v1/`, extract
+      `<LegacyApp />` into `src/LegacyApp.tsx`, write `<V1App />` mirroring legacy routes (renders
+      existing page components under v1 chrome until Phases 2-5 swap them), move dormant navbar +
+      theme-toggle + icons + CSS into `src/v1/`, and add the single `isEnabled("V1_REDESIGN")`
+      boundary read in `src/App.tsx`. First PR where the redesign is reachable on `feat/84-*`
+      preview deploys.
 - [ ] Start PR 3 (`feat/84-pr3-subnav`) once PR 2b is in review.
 
 ---
@@ -91,18 +84,18 @@ boundary read in `src/App.tsx`, not per-component sprawl; v1 chrome and pages li
 the existing `netlify.toml` `feat/84-*` pattern selects which sub-app each Netlify deploy bundles.
 Reviewable by one person.
 
-| #   | PR                                                    | Scope                                                                                                                                                                                                                                                                                                                                                                                            | Blocks                        | Status                      |
-| --- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | --------------------------- |
-| 0   | Add `V1_REDESIGN` flag                                | One line in `src/lib/feature-flags.ts`. Ships as a no-op.                                                                                                                                                                                                                                                                                                                                        | All other foundation PRs      | ✅ Done (on `main`)         |
-| 1   | Theme system                                          | `src/styles/` folder (modular CSS partials). Light + dark + auto switching. No-flash init script in `index.html`. Reconcile dark surface tokens. Persist to `localStorage["td-color-theme"]`. `<ThemeToggle />` authored (not rendered). **Note:** dark-surface reconciliation is global (no `V1_REDESIGN` gate); light theme, persistence, and toggle are additive with no consumer until PR 2. | PR 2 (toggle lives in NavBar) | 🚧 Implemented — pending PR |
-| 2   | NavBar v1                                             | **Re-scoped 2026-05-13 (pivot):** navbar component, theme-toggle rewrite, icons, and CSS ship as **dormant** code in `src/components/`; `App.tsx`/`main.tsx` flag wiring reverted; docs capture the pivot. opentelemetry.io-style chrome (always-dark): single "Docs" link, "OpenTelemetry" brand text + `OtelLogo` placeholder, `<ThemeToggle />`. Search and language switcher deferred.       | PR 2b                         | 🚧 Re-scoped — pending PR   |
-| 2b  | v1 scaffolding                                        | Introduce `src/v1/`; move dormant navbar into `src/v1/components/layout/`; add minimal `<V1App />` mounting the navbar + a placeholder home (chrome-only until Phase 2 ships a real one); `src/App.tsx` adds the single boundary read swapping `<V1App />` for `<LegacyApp />`. Canonical paths (no `/v1/*` prefix); per-deploy bundle via existing `netlify.toml` pattern.                      | PR 3 (SubNav sits beneath it) | —                           |
-| 3   | SubNav                                                | Breadcrumb component + optional right-side actions slot. Used by inner pages. Lives in `src/v1/components/layout/`.                                                                                                                                                                                                                                                                              | Phases 2-5                    | —                           |
-| 4   | StatusPill + GlowBadge `secondary` + `error` variants | Add `<StatusPill>` covering all six OTel stability levels (development / alpha / beta / stable / deprecated / unmaintained). Leave legacy `StabilityBadge` untouched; migrate in a follow-up cleanup PR.                                                                                                                                                                                         | Phases 3, 4                   | —                           |
-| 5   | TypeStripe + Card primitive update                    | 4px left-edge stripe primitive (5 colors) + extend `DetailCard` with the stripe slot (not `NavigationCard` — too specialized).                                                                                                                                                                                                                                                                   | Phases 3, 4                   | —                           |
-| 6   | FooterV1 + CncfCallout                                | Two-cluster Docsy-style footer + CNCF callout above it. Inline SVGs for Bluesky / Mastodon / Stack Overflow icons (assuming we go with the recommended icon strategy). Both live in `src/v1/components/layout/`.                                                                                                                                                                                 | —                             | —                           |
-| 7   | Playwright visual regression baseline                 | Configure Playwright. Snapshot each primitive in light + dark. Add `axe-core` for a11y.                                                                                                                                                                                                                                                                                                          | Phase 1 cleanup               | —                           |
-| 8   | Cleanup                                               | Remove the `V1_REDESIGN` boundary read in `src/App.tsx`; delete the `<LegacyApp />` branch and the legacy `Header` / `Footer` plus replaced `src/features/...` content; remove the `V1_REDESIGN` entry from `lib/feature-flags.ts` and the `feat/84-*` pattern from `netlify.toml`; update `DESIGN.md` to reflect as-built.                                                                      | Phase 2                       | —                           |
+| #   | PR                                                    | Scope                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Blocks                        | Status                      |
+| --- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | --------------------------- |
+| 0   | Add `V1_REDESIGN` flag                                | One line in `src/lib/feature-flags.ts`. Ships as a no-op.                                                                                                                                                                                                                                                                                                                                                                                                                                                           | All other foundation PRs      | ✅ Done (on `main`)         |
+| 1   | Theme system                                          | `src/styles/` folder (modular CSS partials). Light + dark + auto switching. No-flash init script in `index.html`. Reconcile dark surface tokens. Persist to `localStorage["td-color-theme"]`. `<ThemeToggle />` authored (not rendered). **Note:** dark-surface reconciliation is global (no `V1_REDESIGN` gate); light theme, persistence, and toggle are additive with no consumer until PR 2.                                                                                                                    | PR 2 (toggle lives in NavBar) | 🚧 Implemented — pending PR |
+| 2   | NavBar v1                                             | **Re-scoped 2026-05-13 (pivot):** navbar component, theme-toggle rewrite, icons, and CSS ship as **dormant** code in `src/components/`; `App.tsx`/`main.tsx` flag wiring reverted; docs capture the pivot. opentelemetry.io-style chrome (always-dark): single "Docs" link, "OpenTelemetry" brand text + `OtelLogo` placeholder, `<ThemeToggle />`. Search and language switcher deferred.                                                                                                                          | PR 2b                         | ✅ Done (#453)              |
+| 2b  | v1 scaffolding                                        | Introduce `src/v1/`; move dormant navbar/theme-toggle/icons into `src/v1/`; extract `<LegacyApp />` into `src/LegacyApp.tsx`; add `<V1App />` mirroring legacy routes (rendering existing page components under v1 chrome until Phase 2-5 swap them); `src/App.tsx` reduces to a single `isEnabled("V1_REDESIGN")` boundary read. v1 chrome reuses legacy `<Footer />` as a placeholder until PR 6. CSS scoped via `.v1-app` class wrapper. Canonical paths; per-deploy bundle via existing `netlify.toml` pattern. | PR 3 (SubNav sits beneath it) | 🚧 Pending PR               |
+| 3   | SubNav                                                | Breadcrumb component + optional right-side actions slot. Used by inner pages. Lives in `src/v1/components/layout/`.                                                                                                                                                                                                                                                                                                                                                                                                 | Phases 2-5                    | —                           |
+| 4   | StatusPill + GlowBadge `secondary` + `error` variants | Add `<StatusPill>` covering all six OTel stability levels (development / alpha / beta / stable / deprecated / unmaintained). Leave legacy `StabilityBadge` untouched; migrate in a follow-up cleanup PR.                                                                                                                                                                                                                                                                                                            | Phases 3, 4                   | —                           |
+| 5   | TypeStripe + Card primitive update                    | 4px left-edge stripe primitive (5 colors) + extend `DetailCard` with the stripe slot (not `NavigationCard` — too specialized).                                                                                                                                                                                                                                                                                                                                                                                      | Phases 3, 4                   | —                           |
+| 6   | FooterV1 + CncfCallout                                | Two-cluster Docsy-style footer + CNCF callout above it. Inline SVGs for Bluesky / Mastodon / Stack Overflow icons (assuming we go with the recommended icon strategy). Both live in `src/v1/components/layout/`.                                                                                                                                                                                                                                                                                                    | —                             | —                           |
+| 7   | Playwright visual regression baseline                 | Configure Playwright. Snapshot each primitive in light + dark. Add `axe-core` for a11y.                                                                                                                                                                                                                                                                                                                                                                                                                             | Phase 1 cleanup               | —                           |
+| 8   | Cleanup                                               | Remove the `V1_REDESIGN` boundary read in `src/App.tsx`; delete the `<LegacyApp />` branch and the legacy `Header` / `Footer` plus replaced `src/features/...` content; remove the `V1_REDESIGN` entry from `lib/feature-flags.ts` and the `feat/84-*` pattern from `netlify.toml`; update `DESIGN.md` to reflect as-built.                                                                                                                                                                                         | Phase 2                       | —                           |
 
 PR 8 is the **go-live** moment — once it merges, Phase 1 is done and the new chrome ships to
 production.
@@ -214,34 +207,35 @@ Surface early so it's not blocking when PR 04b is ready.
 
 ## Decision log
 
-| Date       | Decision                                                                                                                                                                                                                                                                                             | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 2026-04-30 | Direction: "The Catalog" with borrowed elements from Atlas + Dashboard                                                                                                                                                                                                                               | See design brief. v1 spine: searchable, comparable, version-aware database.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| 2026-04-30 | Align visual chrome with opentelemetry.io                                                                                                                                                                                                                                                            | Same nav, footer, hero, stats, theme system, brand colors. Sub-product, not a separate microsite.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| 2026-05-05 | Stage Phase 1 into 9 PRs gated by `V1_REDESIGN` flag                                                                                                                                                                                                                                                 | See "Phase 1 PR sequence" above. Avoids one big-bang PR.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| 2026-05-05 | Reuse existing feature-flag system at `src/lib/feature-flags.ts`                                                                                                                                                                                                                                     | Already in production use; no new infrastructure.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| 2026-05-05 | Migration strategy: feature-flagged side-by-side, swap in cleanup PR                                                                                                                                                                                                                                 | Per Vitor's choice in our sync.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| 2026-05-05 | Set up `CLAUDE.local.md` (gitignored) with handling rules for `projects/` during the refactor                                                                                                                                                                                                        | Personal session context for Claude; not shared with the project. Ensures continuity across sessions.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| 2026-05-06 | Netlify previews enable `V1_REDESIGN` automatically for `feat/84-*` branches via build-command pattern matching in `netlify.toml`                                                                                                                                                                    | Reviewers see the flag-on view per PR with no manual env-var setup. Production stays off.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| 2026-05-06 | Keep `data-theme` (not `data-bs-theme`) on `<html>` for the theme attribute                                                                                                                                                                                                                          | Foundation audit Q1. opentelemetry.io uses `data-bs-theme` because Hugo Docsy is Bootstrap-based; the explorer is on Tailwind v4 with no Bootstrap. Visual alignment is driven by colors / layout / patterns, not the attribute name. Smaller PR diff and more honest naming.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| 2026-05-06 | Stick with the local `OtelLogo` component for the navbar lockup                                                                                                                                                                                                                                      | Foundation audit Q2. Self-contained, no extra fetch dependency, already used elsewhere in the codebase.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| 2026-05-06 | Footer icons: inline SVGs for missing brand marks (Bluesky, Mastodon, Stack Overflow); Lucide for everything else                                                                                                                                                                                    | Foundation audit Q3 — option (c). Avoids adding ~75kb of Font Awesome for a handful of icons; keeps the bundle lean.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| 2026-05-06 | `<StatusPill>` ships in PR 4 alongside `<StabilityBadge>`; migrate the configuration builder to `<StatusPill>` in a follow-up cleanup PR after Phase 1                                                                                                                                               | Foundation audit Q4. `<StabilityBadge>` is narrow (one state, specific to the Java config builder). Building `<StatusPill>` without churning the configuration builder keeps PR 4 small and decouples the visual-decision risk.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| 2026-05-06 | Status terminology follows the [OTel collector stability spec](https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/component-stability.md) — six levels: development / alpha / beta / stable / deprecated / unmaintained                                                        | Foundation audit Q5. Color mapping: development=secondary (gray), alpha=warning (orange), beta=info (blue), stable=success (green), deprecated=danger (red), unmaintained=danger (red). Mirrors the collector's vocabulary so anyone reading both sources sees the same terms.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| 2026-05-06 | PR 0 confirmed done — `V1_REDESIGN` is already in `src/lib/feature-flags.ts` on `main`                                                                                                                                                                                                               | Added alongside `JAVA_RELEASE_COMPARISON` in a prior merge. `netlify.toml` was also already wired for `feat/84-*` previews. Flag is a no-op until PR 2 wires it into `App.tsx`. First real work is PR 1.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| 2026-05-06 | PR 5 will extend `DetailCard`, not `NavigationCard`                                                                                                                                                                                                                                                  | Verified by reading both components. `DetailCard` is a general-purpose wrapper (`children` + `className` passthrough) — clean fit for a `typeStripe` prop. `NavigationCard` is specialized (hardcoded icon box, arrow, corner accent); restructuring it for the stripe slot is not worth the churn.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| 2026-05-06 | Branch `feat/84-pr1-theme-system` created from `feat/84-layout-mockups`                                                                                                                                                                                                                              | PR 1 stacks on the planning branch so planning artifacts and first code PR can ship together (separate reviews).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| 2026-05-06 | No SCSS — use pure CSS partials in `src/styles/` (Tailwind v4 is the preprocessor)                                                                                                                                                                                                                   | Tailwind v4 [explicitly recommends against SCSS/Less/Stylus](https://tailwindcss.com/docs/compatibility#sass-less-and-stylus); it ships nesting, `@import` bundling, and vendor prefixing via Lightning CSS. All architecture goals (declared variables, folder structure, separation of concerns) achieved with plain CSS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| 2026-05-06 | Brand realignment (`primary = blue`, `secondary = orange`) confirmed already on `main`; PR 1 does not flip these values                                                                                                                                                                              | Re-reading `src/index.css` during the session revealed the canonical hues are already in place. PR 1 only reconciles the five remaining dark surface tokens (card/muted/border) and adds the light theme block.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| 2026-05-06 | PR 1 `theme-context.tsx` API: `{ mode, resolved, setMode }` — `mode` is the user preference (`light`/`dark`/`auto`), `resolved` is what's applied to the document                                                                                                                                    | Cleaner than the old `{ themeId, setThemeId }` API. CSS owns values via `[data-theme]`; JS only sets the attribute. `useTheme` has zero non-test production consumers so the API reshaping is free.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| 2026-05-07 | PR 1 dark-surface reconciliation lands globally on `main`; `V1_REDESIGN` gates UI components/layout, not the base palette                                                                                                                                                                            | Brand hues already on `main`; only the secondary surface tokens shift, and only for dark-theme users. Keeps PR 1 small and avoids a CSS indirection that PR 8 cleanup would have to unwind.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| 2026-05-07 | Drop `dark-blue` alias from `themes.ts` — the prior theme code never wrote to `localStorage`, so the alias was dead code with no real users behind it                                                                                                                                                | The `td-color-theme` storage key is brand-new in PR 1; no migration needed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| 2026-05-11 | Hero restored to orange-dominant after primary/secondary swap                                                                                                                                                                                                                                        | Compass glow + ambient radial use `--otel-orange-hsl`; text gradient runs blue→orange. Addresses Jay's PR review feedback that "all the oranges turned blue except for the compass center dot."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| 2026-05-11 | PR 2 scope cut to a minimal Docs-only navbar; search input, language switcher, and the opentelemetry.io multi-link strip deferred to later phases                                                                                                                                                    | Per Vitor: visual parity with opentelemetry.io's chrome matters, exact link list doesn't. Single "Docs" link → `https://opentelemetry.io/docs/`. Brand text "OpenTelemetry"; logo mocked with existing `OtelLogo` until upstream horizontal SVG is provided. Always-dark surface tokens added to `src/styles/tokens.css`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| 2026-05-11 | PR 2 navbar metrics re-anchored to the opentelemetry.io source (local clone at `/Users/vasconcellos/projetos/opentelemetry/opentelemetry.io`) instead of the static mockup                                                                                                                           | Mockup colors and heights diverged from the live site. Tokens now mirror `_navbar.scss`/`navbar.html` verbatim: bg `#3d4c86`, logo SVG 48px (white via `currentColor`), no border-bottom, nav-link 16px/600, min-height 104px (pixel-anchored because the explorer uses 14px rem). New `OpenTelemetryWordmark` component bundles the upstream SVG (mark + wordmark in one piece).                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| 2026-05-11 | `<ThemeToggle />` rebuilt as a 3-option Radix dropdown to mirror opentelemetry.io's Bootstrap theme-toggler (Light · Dark · Auto rows visible at once, circle-half trigger)                                                                                                                          | Was a click-to-cycle button in PR 1; opentelemetry.io ships a dropdown so users can see all options. Radix `react-dropdown-menu` added as a dep alongside the existing Radix primitives. Storage contract (`td-color-theme`, `mode`/`resolved`/`setMode`) is unchanged.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| 2026-05-11 | Future redesign work treats the local `opentelemetry.io` clone as source of truth for shared chrome — see the new section in `CLAUDE.local.md`                                                                                                                                                       | The mockup is a sketch; the live site is authoritative for navbar/footer/theme-toggle/CNCF/brand metrics. Always grep `assets/scss/_navbar.scss`, `themes/docsy/layouts/_partials/`, and quote actual values.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| 2026-05-11 | PR 2 navbar implementation switched from Tailwind utilities to **scoped CSS partials** (`src/styles/navbar.css`, `src/styles/theme-toggle.css`) that mirror the upstream SCSS verbatim                                                                                                               | Tailwind utilities couldn't express `text-decoration-thickness` / `text-underline-offset` and the growing arbitrary-value soup was hard to keep in sync with opentelemetry.io. Pixel-anchored at 16px-rem inside `.td-navbar` to neutralise the explorer's global 14px rem. Restored `position: fixed` + `min-height: 64px` (was 104px, which is mobile-stacked metrics misapplied to desktop). Right-alignment now via `.td-navbar-nav-scroll { margin-left: auto }` wrapper, mirroring upstream. Hover renders a 3px orange underline at 0.5em offset. Theme-toggle icons switched from Lucide to inline Bootstrap-Icons SVGs (`sun-fill`, `moon-stars-fill`, `circle-half`); active row indicated by background colour only (no checkmark, matching upstream). Trigger icon mirrors current mode. |
-| 2026-05-12 | Pivot: `V1_REDESIGN` gates at the router boundary (single read in `App.tsx` swapping `<V1App />` for `<LegacyApp />`), not per-component. New `src/v1/` directory owns chrome + page-level features; primitives stay in `src/components/ui/`. Per-deploy bundle via existing `netlify.toml` pattern. | Decided on the OpenTelemetry Communications SIG call ([Zoom recording](https://zoom.us/rec/play/6w6ij69psp17Vo3GaZeaarr7mDGOfrUNE2m7HuIDb1XCwKvmnBWzWkcli9lU3Q3xMyqeFa3aNxyFWJs.WcZZoY03UygQ-toH)); refined via grilling on 2026-05-13. See [`v1-routing-pivot.md`](./v1-routing-pivot.md). Supersedes the 2026-05-05 rows "Stage Phase 1 into 9 PRs gated by V1_REDESIGN" and "Migration strategy: feature-flagged side-by-side". PR 2 (#453) re-scoped to docs + dormant code; new PR 2b adds the scaffolding.                                                                                                                                                                                                                                                                                     |
+| Date       | Decision                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 2026-04-30 | Direction: "The Catalog" with borrowed elements from Atlas + Dashboard                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | See design brief. v1 spine: searchable, comparable, version-aware database.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| 2026-04-30 | Align visual chrome with opentelemetry.io                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Same nav, footer, hero, stats, theme system, brand colors. Sub-product, not a separate microsite.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| 2026-05-05 | Stage Phase 1 into 9 PRs gated by `V1_REDESIGN` flag                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | See "Phase 1 PR sequence" above. Avoids one big-bang PR.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| 2026-05-05 | Reuse existing feature-flag system at `src/lib/feature-flags.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Already in production use; no new infrastructure.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| 2026-05-05 | Migration strategy: feature-flagged side-by-side, swap in cleanup PR                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Per Vitor's choice in our sync.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| 2026-05-05 | Set up `CLAUDE.local.md` (gitignored) with handling rules for `projects/` during the refactor                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Personal session context for Claude; not shared with the project. Ensures continuity across sessions.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| 2026-05-06 | Netlify previews enable `V1_REDESIGN` automatically for `feat/84-*` branches via build-command pattern matching in `netlify.toml`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Reviewers see the flag-on view per PR with no manual env-var setup. Production stays off.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| 2026-05-06 | Keep `data-theme` (not `data-bs-theme`) on `<html>` for the theme attribute                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Foundation audit Q1. opentelemetry.io uses `data-bs-theme` because Hugo Docsy is Bootstrap-based; the explorer is on Tailwind v4 with no Bootstrap. Visual alignment is driven by colors / layout / patterns, not the attribute name. Smaller PR diff and more honest naming.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| 2026-05-06 | Stick with the local `OtelLogo` component for the navbar lockup                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Foundation audit Q2. Self-contained, no extra fetch dependency, already used elsewhere in the codebase.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| 2026-05-06 | Footer icons: inline SVGs for missing brand marks (Bluesky, Mastodon, Stack Overflow); Lucide for everything else                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Foundation audit Q3 — option (c). Avoids adding ~75kb of Font Awesome for a handful of icons; keeps the bundle lean.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| 2026-05-06 | `<StatusPill>` ships in PR 4 alongside `<StabilityBadge>`; migrate the configuration builder to `<StatusPill>` in a follow-up cleanup PR after Phase 1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Foundation audit Q4. `<StabilityBadge>` is narrow (one state, specific to the Java config builder). Building `<StatusPill>` without churning the configuration builder keeps PR 4 small and decouples the visual-decision risk.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| 2026-05-06 | Status terminology follows the [OTel collector stability spec](https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/component-stability.md) — six levels: development / alpha / beta / stable / deprecated / unmaintained                                                                                                                                                                                                                                                                                                                                                                                         | Foundation audit Q5. Color mapping: development=secondary (gray), alpha=warning (orange), beta=info (blue), stable=success (green), deprecated=danger (red), unmaintained=danger (red). Mirrors the collector's vocabulary so anyone reading both sources sees the same terms.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| 2026-05-06 | PR 0 confirmed done — `V1_REDESIGN` is already in `src/lib/feature-flags.ts` on `main`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Added alongside `JAVA_RELEASE_COMPARISON` in a prior merge. `netlify.toml` was also already wired for `feat/84-*` previews. Flag is a no-op until PR 2 wires it into `App.tsx`. First real work is PR 1.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| 2026-05-06 | PR 5 will extend `DetailCard`, not `NavigationCard`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Verified by reading both components. `DetailCard` is a general-purpose wrapper (`children` + `className` passthrough) — clean fit for a `typeStripe` prop. `NavigationCard` is specialized (hardcoded icon box, arrow, corner accent); restructuring it for the stripe slot is not worth the churn.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| 2026-05-06 | Branch `feat/84-pr1-theme-system` created from `feat/84-layout-mockups`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | PR 1 stacks on the planning branch so planning artifacts and first code PR can ship together (separate reviews).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| 2026-05-06 | No SCSS — use pure CSS partials in `src/styles/` (Tailwind v4 is the preprocessor)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Tailwind v4 [explicitly recommends against SCSS/Less/Stylus](https://tailwindcss.com/docs/compatibility#sass-less-and-stylus); it ships nesting, `@import` bundling, and vendor prefixing via Lightning CSS. All architecture goals (declared variables, folder structure, separation of concerns) achieved with plain CSS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| 2026-05-06 | Brand realignment (`primary = blue`, `secondary = orange`) confirmed already on `main`; PR 1 does not flip these values                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Re-reading `src/index.css` during the session revealed the canonical hues are already in place. PR 1 only reconciles the five remaining dark surface tokens (card/muted/border) and adds the light theme block.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| 2026-05-06 | PR 1 `theme-context.tsx` API: `{ mode, resolved, setMode }` — `mode` is the user preference (`light`/`dark`/`auto`), `resolved` is what's applied to the document                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Cleaner than the old `{ themeId, setThemeId }` API. CSS owns values via `[data-theme]`; JS only sets the attribute. `useTheme` has zero non-test production consumers so the API reshaping is free.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| 2026-05-07 | PR 1 dark-surface reconciliation lands globally on `main`; `V1_REDESIGN` gates UI components/layout, not the base palette                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Brand hues already on `main`; only the secondary surface tokens shift, and only for dark-theme users. Keeps PR 1 small and avoids a CSS indirection that PR 8 cleanup would have to unwind.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| 2026-05-07 | Drop `dark-blue` alias from `themes.ts` — the prior theme code never wrote to `localStorage`, so the alias was dead code with no real users behind it                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The `td-color-theme` storage key is brand-new in PR 1; no migration needed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| 2026-05-11 | Hero restored to orange-dominant after primary/secondary swap                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Compass glow + ambient radial use `--otel-orange-hsl`; text gradient runs blue→orange. Addresses Jay's PR review feedback that "all the oranges turned blue except for the compass center dot."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| 2026-05-11 | PR 2 scope cut to a minimal Docs-only navbar; search input, language switcher, and the opentelemetry.io multi-link strip deferred to later phases                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Per Vitor: visual parity with opentelemetry.io's chrome matters, exact link list doesn't. Single "Docs" link → `https://opentelemetry.io/docs/`. Brand text "OpenTelemetry"; logo mocked with existing `OtelLogo` until upstream horizontal SVG is provided. Always-dark surface tokens added to `src/styles/tokens.css`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| 2026-05-11 | PR 2 navbar metrics re-anchored to the opentelemetry.io source (local clone at `/Users/vasconcellos/projetos/opentelemetry/opentelemetry.io`) instead of the static mockup                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Mockup colors and heights diverged from the live site. Tokens now mirror `_navbar.scss`/`navbar.html` verbatim: bg `#3d4c86`, logo SVG 48px (white via `currentColor`), no border-bottom, nav-link 16px/600, min-height 104px (pixel-anchored because the explorer uses 14px rem). New `OpenTelemetryWordmark` component bundles the upstream SVG (mark + wordmark in one piece).                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| 2026-05-11 | `<ThemeToggle />` rebuilt as a 3-option Radix dropdown to mirror opentelemetry.io's Bootstrap theme-toggler (Light · Dark · Auto rows visible at once, circle-half trigger)                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Was a click-to-cycle button in PR 1; opentelemetry.io ships a dropdown so users can see all options. Radix `react-dropdown-menu` added as a dep alongside the existing Radix primitives. Storage contract (`td-color-theme`, `mode`/`resolved`/`setMode`) is unchanged.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| 2026-05-11 | Future redesign work treats the local `opentelemetry.io` clone as source of truth for shared chrome — see the new section in `CLAUDE.local.md`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | The mockup is a sketch; the live site is authoritative for navbar/footer/theme-toggle/CNCF/brand metrics. Always grep `assets/scss/_navbar.scss`, `themes/docsy/layouts/_partials/`, and quote actual values.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| 2026-05-11 | PR 2 navbar implementation switched from Tailwind utilities to **scoped CSS partials** (`src/styles/navbar.css`, `src/styles/theme-toggle.css`) that mirror the upstream SCSS verbatim                                                                                                                                                                                                                                                                                                                                                                                                                                                | Tailwind utilities couldn't express `text-decoration-thickness` / `text-underline-offset` and the growing arbitrary-value soup was hard to keep in sync with opentelemetry.io. Pixel-anchored at 16px-rem inside `.td-navbar` to neutralise the explorer's global 14px rem. Restored `position: fixed` + `min-height: 64px` (was 104px, which is mobile-stacked metrics misapplied to desktop). Right-alignment now via `.td-navbar-nav-scroll { margin-left: auto }` wrapper, mirroring upstream. Hover renders a 3px orange underline at 0.5em offset. Theme-toggle icons switched from Lucide to inline Bootstrap-Icons SVGs (`sun-fill`, `moon-stars-fill`, `circle-half`); active row indicated by background colour only (no checkmark, matching upstream). Trigger icon mirrors current mode. |
+| 2026-05-12 | Pivot: `V1_REDESIGN` gates at the router boundary (single read in `App.tsx` swapping `<V1App />` for `<LegacyApp />`), not per-component. New `src/v1/` directory owns chrome + page-level features; primitives stay in `src/components/ui/`. Per-deploy bundle via existing `netlify.toml` pattern.                                                                                                                                                                                                                                                                                                                                  | Decided on the OpenTelemetry Communications SIG call ([Zoom recording](https://zoom.us/rec/play/6w6ij69psp17Vo3GaZeaarr7mDGOfrUNE2m7HuIDb1XCwKvmnBWzWkcli9lU3Q3xMyqeFa3aNxyFWJs.WcZZoY03UygQ-toH)); refined via grilling on 2026-05-13. See [`v1-routing-pivot.md`](./v1-routing-pivot.md). Supersedes the 2026-05-05 rows "Stage Phase 1 into 9 PRs gated by V1_REDESIGN" and "Migration strategy: feature-flagged side-by-side". PR 2 (#453) re-scoped to docs + dormant code; new PR 2b adds the scaffolding.                                                                                                                                                                                                                                                                                     |
+| 2026-05-13 | PR 2b shape locked via grilling: PR 6 stays separate; `<V1App />` mirrors legacy routes rendering existing page components inside v1 chrome (each phase swaps its route's component); boundary read uses `isEnabled("V1_REDESIGN")` and both branches ship in both bundles (computed-key env access skips Vite's constant-fold); `<LegacyApp />` lives at `src/LegacyApp.tsx`; v1 reuses legacy `<Footer />` as placeholder until PR 6; CSS scoped via `.v1-app` class applied both to `<html>` (via a single carve-out flag read in `main.tsx`, restoring the body-bg behavior reverted by PR 453) and to `<V1App />`'s wrapper div. | Trade-offs: convention consistency for the boundary read over per-deploy bundle separation (~5KB JS + ~11KB CSS unused per build, acceptable). The `main.tsx` carve-out exists so body bg paints against v1 surface tokens from the first paint — body itself lives outside `<V1App />`'s wrapper subtree, so the cascade only reaches body when `.v1-app` is on `<html>`. PR 8 cleanup removes both the carve-out and the App.tsx boundary read. Each Phase 2-5 PR edits `V1App.tsx`'s route table to swap in its v1 component; `LegacyApp.tsx`'s table is frozen until PR 8 deletes it. Resolves the foundation-audit "PR 2b decides CSS scoping" open question.                                                                                                                                   |
 
 Add a row whenever a decision lands. Keeps the doc honest.
diff --git a/projects/84-ui-ux-design/v1-routing-pivot.md b/projects/84-ui-ux-design/v1-routing-pivot.md
index 97f528012..ec2a9d319 100644
--- a/projects/84-ui-ux-design/v1-routing-pivot.md
+++ b/projects/84-ui-ux-design/v1-routing-pivot.md
@@ -53,27 +53,44 @@ Concretely:
   top-level component `<V1App />` defines its own `<Routes>`.
 - **`src/App.tsx` reduces to a single boundary read:**
   `isEnabled("V1_REDESIGN") ? <V1App /> : <LegacyApp />`. That is the only place `V1_REDESIGN` is
-  referenced in runtime code. No flag reads in `main.tsx`, no flag reads inside components, no
-  `data-v1-redesign` attribute on `<html>`.
+  referenced for application routing decisions. No `data-v1-redesign` attribute on `<html>` (the
+  class-based scoping below replaces it).
+- **One narrow carve-out in `main.tsx` for early-paint styling.** `main.tsx` reads the flag once to
+  add the `.v1-app` class to `<html>` before React mounts. This keeps body bg painted against v1
+  surface tokens from the first paint (zero navy-to-v1 flash during the React mount window). The
+  check uses the same `isEnabled("V1_REDESIGN")` API as the App.tsx boundary read, so it's a runtime
+  check that fires once at module load, not a build-time constant. CSS variables declared on
+  `.v1-app` cascade through `<body>` via `body { background-color: hsl(var(--background-hsl)) }` in
+  `src/styles/base.css`. PR 2b implements this; PR 8 cleanup removes it along with the App.tsx
+  boundary read.
 - **No URL prefix.** v1 mounts at the canonical paths (`/`, `/java-agent/...`, etc.). Both sub-apps
   own the same path space; the boundary read decides which one is reachable.
 - **Per-deploy bundle selection.** The existing `netlify.toml` pattern (`feat/84-*` branches set
-  `VITE_FEATURE_FLAG_V1_REDESIGN=true`) is unchanged. Tree-shaking strips the unreachable branch
-  from each build: `feat/84-*` previews ship v1 only; `main` and production ship legacy only.
-  Reviewers compare a PR's preview to the production URL side-by-side in two tabs.
+  `VITE_FEATURE_FLAG_V1_REDESIGN=true`) is unchanged. The boundary read is a runtime check, not a
+  build-time switch: `isEnabled("V1_REDESIGN")` reads `import.meta.env` via a computed key, which
+  Vite's static-replacement pass cannot constant-fold. Both `<V1App />` and `<LegacyApp />` ship in
+  both bundles (~5KB JS + ~11KB CSS unused per build); the runtime check picks which one mounts.
+  Tree-shaking the unreachable branch is aspirational and would require either switching the
+  boundary to literal-key `import.meta.env.VITE_FEATURE_FLAG_V1_REDESIGN` or using `React.lazy()`
+  for explicit code-splitting. Accepted trade-off for convention consistency with the rest of the
+  codebase's flag reads. Reviewers compare a PR's preview to the production URL side-by-side in two
+  tabs.
 
 **Shared-primitives placement.** Cross-cutting primitives stay in `src/components/ui/` — that
 includes `StatusPill`, `GlowBadge`, `ThemeToggle`, and future `TypeStripe` / `Card` work. Chrome and
 page-level features that exist only for v1 live under `src/v1/`. No retroactive moves of code
 already merged on `main` (PR 1 theme system, PR 4 StatusPill).
 
-**Cutover model.** The cleanup PR (PR 8) does four things in one diff:
+**Cutover model.** The cleanup PR (PR 8) does five things in one diff:
 
 1. Removes the `isEnabled("V1_REDESIGN")` read in `src/App.tsx`.
-2. Deletes the `<LegacyApp />` branch.
-3. Deletes legacy chrome (`src/components/layout/header.tsx`, the legacy `Footer`) and legacy
+2. Removes the `main.tsx` carve-out that adds `.v1-app` to `<html>` pre-mount (after cutover, v1 is
+   unconditional, so the class can move to a static `<html class="v1-app">` in `index.html` — or the
+   v1 surface tokens can move back to `:root` since they're the only palette).
+3. Deletes the `<LegacyApp />` branch.
+4. Deletes legacy chrome (`src/components/layout/header.tsx`, the legacy `Footer`) and legacy
    feature directories that v1 has replaced.
-4. Removes the `V1_REDESIGN` entry from `src/lib/feature-flags.ts` and the `feat/84-*` pattern from
+5. Removes the `V1_REDESIGN` entry from `src/lib/feature-flags.ts` and the `feat/84-*` pattern from
    `netlify.toml`.
 
 After cutover, v1 is the only app. `src/v1/` stays in place; a future flattening (hoisting
@@ -94,7 +111,10 @@ After cutover, v1 is the only app. `src/v1/` stays in place; a future flattening
 - **PRs 4 (StatusPill — already shipped), 5 (TypeStripe + Card), 7 (Playwright)** continue to use
   `src/components/ui/`. Cross-cutting primitives stay shared.
 - **CSS scoping that depended on the `data-v1-redesign` attribute** moves into v1-only stylesheets
-  imported by `src/v1/`, or gets scoped via a class set by `<V1App />`. PR 2b decides which.
+  imported by `src/v1/` under the `.v1-app` class. `main.tsx`'s one-line carve-out (above) sets the
+  class on `<html>` pre-mount so the cascade reaches `<body>`. `<V1App />`'s wrapper
+  `<div className="v1-app">` also carries the class for nested scoping. **Locked in PR 2b's grilling
+  session (2026-05-13).**
 
 ## Supersedes
 
@@ -104,7 +124,9 @@ This decision supersedes three rows in the NEXT-STEPS.md decision log:
   of small PRs (now ten including PR 2b), and still gated by `V1_REDESIGN` — but "gated" now means a
   single boundary read, not per-component sprawl.
 - **2026-05-05 — "Migration strategy: feature-flagged side-by-side, swap in cleanup PR."** Now:
-  directory-separated; per-deploy bundle via tree-shaking; swap is still in the cleanup PR but is a
+  directory-separated; per-deploy bundle via the runtime boundary read (tree-shaking the unreachable
+  branch isn't currently in play because `isEnabled()` uses computed-key env access that Vite can't
+  constant-fold; both branches ship in both bundles); swap is still in the cleanup PR but is a
   delete-the-other-half diff rather than a flag flip.
 - **2026-05-07 — "PR 1 dark-surface reconciliation lands globally on `main`; V1_REDESIGN gates UI
   components/layout, not the base palette."** Still accurate; the gate just moved from per-component