Extract OpenKnowledge marketing site into a private ok-marketing app

docs/next.config.ts

@@ -1,6 +1,13 @@
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { withMicrofrontends } from '@vercel/microfrontends/next/config';
 import { createMDX } from 'fumadocs-mdx/next';
 import type { NextConfig } from 'next';
 
+// Routing home is `/docs` — this app serves no landing page at `/`. In the
+// production deployment the apex `/` is served by a separate app, so `/` never
+// reaches this project there; a standalone deployment should set its default
+// route to `/docs`.
 const nextConfig: NextConfig = {
   reactStrictMode: true,
   reactCompiler: {
@@ -125,5 +132,13 @@ const nextConfig: NextConfig = {
 };
 
 const withMDX = createMDX();
+const baseConfig = withMDX(nextConfig);
 
-export default withMDX(nextConfig);
+// `withMicrofrontends` requires a microfrontends.json that declares this app. That
+// file names the private marketing app and is a Microfrontends deploy concern of
+// agents-private only, so it is excluded from the public mirror — the standalone
+// OSS docs build has none. Apply the wrapper only when the config is present,
+// leaving the mirror (and any standalone clone) a plain Next.js app.
+const microfrontendsConfig = fileURLToPath(new URL('./microfrontends.json', import.meta.url));
+
+export default existsSync(microfrontendsConfig) ? withMicrofrontends(baseConfig) : baseConfig;

docs/package.json

@@ -17,23 +17,12 @@
     "postinstall": "fumadocs-mdx"
   },
   "dependencies": {
-    "@codemirror/commands": "^6.10.3",
-    "@codemirror/lang-markdown": "^6.5.0",
-    "@codemirror/language": "^6.12.3",
-    "@codemirror/state": "^6.6.0",
-    "@codemirror/view": "^6.41.0",
-    "@floating-ui/dom": "^1.7.6",
     "@hookform/resolvers": "^5.4.0",
     "@inkeep/cxkit-react": "^0.5.117",
     "@inkeep/open-knowledge-core": "workspace:*",
     "@radix-ui/react-popover": "^1.1.17",
-    "@tiptap/core": "^3.22.3",
-    "@tiptap/extension-drag-handle": "3.22.3",
-    "@tiptap/extensions": "^3.22.3",
-    "@tiptap/pm": "^3.22.3",
-    "@tiptap/react": "^3.22.3",
-    "@tiptap/suggestion": "^3.22.3",
     "@types/mdx": "^2.0.13",
+    "@vercel/microfrontends": "^2.3.6",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "fumadocs-core": "~16.1.0",

docs/src/app/(home)/brand/page.tsx

@@ -1,9 +1,9 @@
 import type { Metadata } from 'next';
+import { SiteFooter } from '@/components/footer';
+import { MarketingButton } from '@/components/marketing-button';
+import SectionHeading from '@/components/section-heading';
 import { BRAND_ASSETS, BRAND_ROUTE, BRAND_ZIP } from '@/lib/brand-assets';
 import { cn } from '@/lib/utils';
-import { SiteFooter } from '../footer';
-import { MarketingButton } from '../marketing-button';
-import SectionHeading from '../section-heading';
 
 export const metadata: Metadata = {
   title: 'Brand assets',