@eventcatalog/core 2.32.2 → 2.33.1

package/eventcatalog/src/pages/chat/feature.astro

@@ -0,0 +1,159 @@
+---
+import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
+import { isEventCatalogChatEnabled as hasEventCatlaogChatLicense } from '@utils/feature';
+import { BotMessageSquare } from 'lucide-react';
+const hasChatLicense = hasEventCatlaogChatLicense();
+
+if (hasChatLicense) {
+  return Astro.redirect('/chat');
+}
+---
+
+<VerticalSideBarLayout title="AI Chat">
+  <div class="min-h-[calc(100vh-60px)] bg-white">
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-16">
+      {/* Hero Section */}
+      <div class="grid grid-cols-1 lg:grid-cols-2 gap-12 items-center mb-16">
+        <div>
+          <div class="inline-flex items-center px-4 py-2 rounded-full bg-purple-100 text-purple-700 font-medium text-sm mb-6">
+            <BotMessageSquare className="w-4 h-4 mr-2" />
+            New: Ask your catalog anything
+          </div>
+          <h1 class="text-4xl font-bold text-gray-900 tracking-tight mb-4">Ask. Understand. Ship faster.</h1>
+          <p class="text-xl text-gray-600 mb-8">
+            Get answers about your events, services, and domains — instantly. Runs entirely in your browser — your data never
+            leaves your machine.
+          </p>
+          <div class="flex flex-col sm:flex-row gap-4 mb-8">
+            <a
+              href="https://demo.eventcatalog.dev/chat"
+              target="_blank"
+              class="inline-flex items-center juNot ready for AI chat? You castify-center px-6 py-3 border border-transparent text-base font-medium rounded-lg text-white bg-purple-600 hover:bg-purple-700 transition-colors duration-150"
+            >
+              Try the demo
+              <svg class="ml-2 w-4 h-4" viewBox="0 0 20 20" fill="currentColor">
+                <path
+                  fill-rule="evenodd"
+                  d="M10.293 3.293a1 1 0 011.414 0l6 6a1 1 0 010 1.414l-6 6a1 1 0 01-1.414-1.414L14.586 11H3a1 1 0 110-2h11.586l-4.293-4.293a1 1 0 010-1.414z"
+                  clip-rule="evenodd"></path>
+              </svg>
+            </a>
+            <a
+              href="https://www.eventcatalog.cloud"
+              target="_blank"
+              class="inline-flex items-center justify-center px-6 py-3 border border-gray-300 text-base font-medium rounded-lg text-gray-700 bg-white hover:bg-gray-50 transition-colors duration-150"
+            >
+              Try for free
+            </a>
+          </div>
+          <p class="text-sm text-gray-500">
+            Available with EventCatalog Starter or Scale plans
+            <a href="https://www.eventcatalog.dev/pricing" class="text-purple-600 font-medium block"
+              >Try free for 14 days, no credit card required</a
+            >
+          </p>
+        </div>
+
+        <div class="relative">
+          <div class="absolute -inset-4">
+            <div
+              class="w-full h-full max-w-full mx-auto opacity-30 blur-lg filter"
+              style="background: linear-gradient(90deg, #C084FC 0%, #818CF8 100%);"
+            >
+            </div>
+          </div>
+          <div class="relative">
+            <div class="bg-white rounded-xl shadow-xl border border-gray-200 overflow-hidden">
+              <div class="bg-gray-50 px-4 py-3 border-b border-gray-200">
+                <div class="flex items-center space-x-2">
+                  <div class="w-3 h-3 bg-red-400 rounded-full"></div>
+                  <div class="w-3 h-3 bg-yellow-400 rounded-full"></div>
+                  <div class="w-3 h-3 bg-green-400 rounded-full"></div>
+                </div>
+              </div>
+              <div class="p-4 space-y-4">
+                <div class="flex justify-end">
+                  <div class="bg-purple-600 text-white rounded-2xl rounded-tr-sm px-4 py-2 max-w-md text-sm">
+                    What services publish order.created?
+                  </div>
+                </div>
+
+                <div class="flex justify-start">
+                  <div class="bg-gray-50 rounded-2xl rounded-tl-sm px-4 py-3 max-w-md shadow-sm">
+                    <p class="text-gray-700 text-sm">
+                      The <span class="font-semibold">Order Service</span> publishes the order.created event.
+                    </p>
+                    <p class="text-gray-700 text-sm mt-2 mb-1">This event is consumed by:</p>
+                    <ul class="space-y-1 text-gray-600 text-sm">
+                      <li>• Payment Service - Initiates payment processing</li>
+                      <li>• Inventory Service - Updates stock levels</li>
+                      <li>• Notification Service - Sends order confirmations</li>
+                    </ul>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      {/* Features Section */}
+      <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-purple-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-purple-600" viewBox="0 0 24 24" fill="currentColor">
+              <path
+                d="M13 7h-2v4H7v2h4v4h2v-4h4v-2h-4V7zm-1-5C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8z"
+              ></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Instant Search</h3>
+          <p class="text-gray-600">
+            Search and understand complex service relationships in seconds with natural language queries.
+          </p>
+        </div>
+
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-purple-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-purple-600" viewBox="0 0 24 24" fill="currentColor">
+              <path
+                d="M9 21c0 .55.45 1 1 1h4c.55 0 1-.45 1-1v-1H9v1zm3-19C8.14 2 5 5.14 5 9c0 2.38 1.19 4.47 3 5.74V17c0 .55.45 1 1 1h6c.55 0 1-.45 1-1v-2.26c1.81-1.27 3-3.36 3-5.74 0-3.86-3.14-7-7-7zm2.85 11.1l-.85.6V16h-4v-2.3l-.85-.6C7.8 12.16 7 10.63 7 9c0-2.76 2.24-5 5-5s5 2.24 5 5c0 1.63-.8 3.16-2.15 4.1z"
+              ></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Smart Insights</h3>
+          <p class="text-gray-600">Get intelligent suggestions and insights about your architecture automatically.</p>
+        </div>
+
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-purple-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-purple-600" viewBox="0 0 24 24" fill="currentColor">
+              <path
+                d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-1 17.93c-3.95-.49-7-3.85-7-7.93 0-.62.08-1.21.21-1.79L9 15v1c0 1.1.9 2 2 2v1.93zm6.9-2.54c-.26-.81-1-1.39-1.9-1.39h-1v-3c0-.55-.45-1-1-1H8v-2h2c.55 0 1-.45 1-1V7h2c1.1 0 2-.9 2-2v-.41c2.93 1.19 5 4.06 5 7.41 0 2.08-.8 3.97-2.1 5.39z"
+              ></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Privacy First</h3>
+          <p class="text-gray-600">All processing happens locally in your browser. Your data never leaves your machine.</p>
+        </div>
+      </div>
+
+      {/* Bottom Link */}
+      <div class="mt-16 text-center">
+        <a
+          href="https://www.eventcatalog.dev/docs/development/guides/customize-sidebars/application-sidebar"
+          target="_blank"
+          class="text-sm text-gray-400 hover:text-gray-500 transition-colors duration-150"
+        >
+          Not ready for AI chat? You can hide this feature in settings
+        </a>
+      </div>
+    </div>
+  </div>
+</VerticalSideBarLayout>
+
+<style>
+  .scroll-smooth {
+    scroll-behavior: smooth;
+  }
+</style>

package/eventcatalog/src/pages/chat/index.astro

@@ -4,9 +4,9 @@ import Chat from '@enterprise/ai-assistant/components/Chat';
 import config from '@config';
 import path from 'node:path';
 import fs from 'node:fs';
-
+import { isEventCatalogChatEnabled } from '@utils/feature';
 import { Code } from 'astro-expressive-code/components';
-
+import { buildUrl } from '@utils/url-builder';
 const isEnabled = config.chat?.enabled || false;
 const chatConfig = config.chat || {};
 
@@ -25,6 +25,10 @@ const generatorConfig = `
     ],
   ],
 `;
+
+if (!isEventCatalogChatEnabled()) {
+  return Astro.redirect(buildUrl('/chat/feature'));
+}
 ---
 
 <VerticalSideBarLayout title="AI Chat">

package/eventcatalog/src/pages/docs/custom/[...path]/index.astro

@@ -3,13 +3,7 @@ import CustomDocumentationPage from '@enterprise/custom-documentation/pages/docs
 import { getCollection } from 'astro:content';
 import { buildUrl } from '@utils/url-builder';
 import type { GetStaticPaths } from 'astro';
-import { isEventCatalogProEnabled } from '@utils/feature';
-import path from 'node:path';
-import fs from 'node:fs';
-
-const PROJECT_DIR = path.resolve(process.env.PROJECT_DIR || process.cwd());
-const CUSTOM_DOCS_DIR = path.resolve(PROJECT_DIR, 'docs/');
-const directoryExists = fs.existsSync(CUSTOM_DOCS_DIR);
+import { isCustomDocsEnabled } from '@utils/feature';
 
 export const getStaticPaths = (async () => {
   const docs = await getCollection('customPages');
@@ -22,8 +16,8 @@ export const getStaticPaths = (async () => {
 
 const props = Astro.props;
 
-if (!isEventCatalogProEnabled()) {
-  return Astro.redirect('/docs/custom');
+if (!isCustomDocsEnabled()) {
+  return Astro.redirect(buildUrl('/docs/custom/feature'));
 }
 ---
 

package/eventcatalog/src/pages/docs/custom/[...path].mdx.ts

@@ -0,0 +1,32 @@
+// This file exposes the markdown for EventCatalog in the Url
+// For example http://localhost:3000/docs/events/OrderAmended/0.0.1 loads the Page and http://localhost:3000/docs/events/OrderAmended/0.0.1.md loads the markdown
+// This is used for the LLMs to load the markdown for the given item (llms.txt);
+
+import type { APIRoute, GetStaticPaths } from 'astro';
+import { getCollection } from 'astro:content';
+import config from '@config';
+import fs from 'fs';
+
+export const getStaticPaths = (async () => {
+  const docs = await getCollection('customPages');
+  const paths = docs.map((doc) => ({
+    params: { path: doc.id.replace('docs/', '') },
+    props: doc,
+    type: 'custom',
+  }));
+  return paths;
+}) satisfies GetStaticPaths;
+
+export const GET: APIRoute = async ({ params, props }) => {
+  // Just return empty array if LLMs are not enabled
+  if (!config.llmsTxt?.enabled) {
+    return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
+  }
+
+  if (props.filePath) {
+    const file = fs.readFileSync(props.filePath, 'utf8');
+    return new Response(file, { status: 200 });
+  }
+
+  return new Response('Not found', { status: 404 });
+};

package/eventcatalog/src/pages/docs/custom/feature.astro

@@ -0,0 +1,165 @@
+---
+import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
+import { BookOpenIcon, FileText } from 'lucide-react';
+---
+
+<VerticalSideBarLayout title="Custom Documentation">
+  <div class="min-h-[calc(100vh-60px)] bg-white">
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-16">
+      {/* Hero Section */}
+      <div class="grid grid-cols-1 lg:grid-cols-2 gap-12 items-center mb-16">
+        <div>
+          <div class="inline-flex items-center px-4 py-2 rounded-full bg-blue-100 text-blue-700 font-medium text-sm mb-6">
+            <FileText className="w-4 h-4 mr-2" />
+            New: Bring your documentation into EventCatalog
+          </div>
+          <h1 class="text-4xl font-bold text-gray-900 tracking-tight mb-4">
+            Document Everything. Share Knowledge. Build Better.
+          </h1>
+          <p class="text-xl text-gray-600 mb-8">
+            Add your own documentation to EventCatalog — from ADRs and system guides to runbooks and onboarding material. Connect
+            your knowledge to your architecture.
+          </p>
+          <div class="flex flex-col sm:flex-row gap-4 mb-8">
+            <a
+              href="https://demo.eventcatalog.dev/docs/custom/guides/creating-new-microservices/01-index"
+              target="_blank"
+              class="inline-flex items-center justify-center px-6 py-3 border border-transparent text-base font-medium rounded-lg text-white bg-blue-600 hover:bg-blue-700 transition-colors duration-150"
+            >
+              View the demo
+              <svg class="ml-2 w-4 h-4" viewBox="0 0 20 20" fill="currentColor">
+                <path
+                  fill-rule="evenodd"
+                  d="M10.293 3.293a1 1 0 011.414 0l6 6a1 1 0 010 1.414l-6 6a1 1 0 01-1.414-1.414L14.586 11H3a1 1 0 110-2h11.586l-4.293-4.293a1 1 0 010-1.414z"
+                  clip-rule="evenodd"></path>
+              </svg>
+            </a>
+            <a
+              href="https://www.eventcatalog.cloud"
+              target="_blank"
+              class="inline-flex items-center justify-center px-6 py-3 border border-gray-300 text-base font-medium rounded-lg text-gray-700 bg-white hover:bg-gray-50 transition-colors duration-150"
+            >
+              Try for free
+            </a>
+          </div>
+          <p class="text-sm text-gray-500">
+            Available with EventCatalog Starter or Scale plans
+            <a href="https://www.eventcatalog.dev/pricing" class="text-blue-600 font-medium block"
+              >Try free for 14 days, no credit card required</a
+            >
+          </p>
+        </div>
+
+        <div class="relative">
+          <div class="absolute -inset-4">
+            <div
+              class="w-full h-full max-w-full mx-auto opacity-30 blur-lg filter"
+              style="background: linear-gradient(90deg, #60A5FA 0%, #3B82F6 100%);"
+            >
+            </div>
+          </div>
+          <div class="relative">
+            <img
+              src="/images/custom-docs-placeholder.png"
+              alt="Custom Documentation Preview"
+              class="rounded-xl shadow-xl border border-gray-200"
+            />
+          </div>
+        </div>
+      </div>
+
+      {/* Features Section */}
+      <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-blue-600" viewBox="0 0 24 24" fill="currentColor">
+              <path d="M14 2H6c-1.1 0-1.99.9-1.99 2L4 20c0 1.1.89 2 1.99 2H18c1.1 0 2-.9 2-2V8l-6-6zM6 20V4h7v5h5v11H6z"></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Centralized Knowledge</h3>
+          <p class="text-gray-600">
+            Keep architecture decisions, system guides, and runbooks in one place — easy to access, easy to trust.
+          </p>
+        </div>
+
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-blue-600" viewBox="0 0 24 24" fill="currentColor">
+              <path
+                d="M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z"
+              ></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Rich Formatting</h3>
+          <p class="text-gray-600">
+            Use Markdown, diagrams, code blocks, and EventCatalog components to create structured, useful documentation.
+          </p>
+        </div>
+
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-blue-600" viewBox="0 0 24 24" fill="currentColor">
+              <path d="M18 2H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zM6 4h5v8l-2.5-1.5L6 12V4z"
+              ></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Version Control</h3>
+          <p class="text-gray-600">Track changes and ensure your documentation grows alongside your system.</p>
+        </div>
+
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-blue-600" viewBox="0 0 24 24" fill="currentColor">
+              <path
+                d="M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z"
+              ></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Documentation Ownership</h3>
+          <p class="text-gray-600">Assign and track document owners, making it easy to find the right person in seconds.</p>
+        </div>
+
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-blue-600" viewBox="0 0 24 24" fill="currentColor">
+              <path d="M3 9h14V7H3v2zm0 4h14v-2H3v2zm0 4h14v-2H3v2zm16 0h2v-2h-2v2zm0-10v2h2V7h-2zm0 6h2v-2h-2v2z"></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">Customizable Sidebars</h3>
+          <p class="text-gray-600">
+            Auto-generated and fully customizable navigation sidebars to organize your documentation perfectly.
+          </p>
+        </div>
+
+        <div class="bg-white rounded-xl p-6 shadow-sm border border-gray-200">
+          <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center mb-4">
+            <svg class="w-6 h-6 text-blue-600" viewBox="0 0 24 24" fill="currentColor">
+              <path d="M20 2H4c-1.1 0-2 .9-2 2v18l4-4h14c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 14H6l-2 2V4h16v12z"></path>
+            </svg>
+          </div>
+          <h3 class="text-lg font-semibold text-gray-900 mb-2">EventCatalog Chat</h3>
+          <p class="text-gray-600">
+            Interact with your documentation using AI-powered chat to find answers quickly and efficiently.
+          </p>
+        </div>
+      </div>
+
+      {/* Bottom Link */}
+      <div class="mt-16 text-center">
+        <a
+          href="https://www.eventcatalog.dev/docs/development/guides/customize-sidebars/application-sidebar"
+          target="_blank"
+          class="text-sm text-gray-400 hover:text-gray-500 transition-colors duration-150"
+        >
+          Not ready for custom documentation? You can hide this feature in settings
+        </a>
+      </div>
+    </div>
+  </div>
+</VerticalSideBarLayout>
+
+<style>
+  .scroll-smooth {
+    scroll-behavior: smooth;
+  }
+</style>

package/eventcatalog/src/pages/docs/custom/index.astro

@@ -1,7 +1,7 @@
 ---
 import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
 import { Code } from 'astro-expressive-code/components';
-import { isEventCatalogProEnabled } from '@utils/feature';
+import { isCustomDocsEnabled } from '@utils/feature';
 
 // Example for folder structure
 const folderStructureExample = `my-catalog/
@@ -92,6 +92,10 @@ module.exports = {
     ]
   }
 }`;
+
+if (!isCustomDocsEnabled()) {
+  return Astro.redirect('/docs/custom/feature');
+}
 ---
 
 <VerticalSideBarLayout title="Custom Documentation">
@@ -121,7 +125,7 @@ module.exports = {
               Read documentation &rarr;
             </a>
             {
-              !isEventCatalogProEnabled() && (
+              !isCustomDocsEnabled() && (
                 <a
                   href="https://www.eventcatalog.dev/pro/trial"
                   class="inline-flex items-center justify-center px-5 py-2 border border-transparent text-sm font-medium rounded-md text-white bg-gradient-to-r from-purple-500 to-purple-700 hover:from-purple-600 hover:to-purple-800 shadow-sm"

package/eventcatalog/src/pages/docs/llm/llms-full.txt.ts

@@ -1,7 +1,10 @@
-import { getCollection } from 'astro:content';
+import { getCollection, type CollectionEntry } from 'astro:content';
 import config from '@config';
 import type { APIRoute } from 'astro';
 import fs from 'fs';
+import { isCustomDocsEnabled } from '@utils/feature';
+
+type AllowedCollections = 'events' | 'commands' | 'queries' | 'services' | 'domains' | 'teams' | 'users' | 'customPages';
 
 const events = await getCollection('events');
 const commands = await getCollection('commands');
@@ -11,12 +14,26 @@ const domains = await getCollection('domains');
 const teams = await getCollection('teams');
 const users = await getCollection('users');
 
+const customDocs = await getCollection('customPages');
+
 export const GET: APIRoute = async ({ params, request }) => {
   if (!config.llmsTxt?.enabled) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  const resources = [...events, ...commands, ...queries, ...services, ...domains, ...teams, ...users];
+  const resources: CollectionEntry<AllowedCollections>[] = [
+    ...events,
+    ...commands,
+    ...queries,
+    ...services,
+    ...domains,
+    ...teams,
+    ...users,
+  ];
+
+  if (isCustomDocsEnabled()) {
+    resources.push(...(customDocs as CollectionEntry<AllowedCollections>[]));
+  }
 
   const content = resources
     .map((item) => {

package/eventcatalog/src/pages/docs/llm/llms.txt.ts

@@ -2,6 +2,8 @@ import { getCollection } from 'astro:content';
 import config from '@config';
 import type { APIRoute } from 'astro';
 
+import { isCustomDocsEnabled } from '@utils/feature';
+
 const events = await getCollection('events');
 const commands = await getCollection('commands');
 const queries = await getCollection('queries');
@@ -12,6 +14,8 @@ const domains = await getCollection('domains');
 const teams = await getCollection('teams');
 const users = await getCollection('users');
 
+const customDocs = await getCollection('customPages');
+
 export const GET: APIRoute = async ({ params, request }) => {
   const url = new URL(request.url);
   const baseUrl = `${url.protocol}//${url.host}`;
@@ -22,6 +26,9 @@ export const GET: APIRoute = async ({ params, request }) => {
   const formatSimpleItem = (item: any, type: string) =>
     `- [${item.id.replace('.mdx', '')}](${baseUrl}/docs/${type}/${item.data.id}.mdx) - ${item.data.name}`;
 
+  const formatCustomDoc = (item: any, route: string) =>
+    `- [${item.data.title}](${baseUrl}/${route}/${item.id.replace('docs\/', '')}.mdx) - ${item.data.summary || ''}`;
+
   const content = [
     `# ${config.organizationName} EventCatalog Documentation\n`,
     `> ${config.tagline}`,
@@ -39,6 +46,9 @@ export const GET: APIRoute = async ({ params, request }) => {
     teams.map((item) => formatSimpleItem(item, 'teams')).join('\n'),
     '\n## Users',
     users.map((item) => formatSimpleItem(item, 'users')).join('\n'),
+    ...(isCustomDocsEnabled()
+      ? ['\n## Custom Docs', customDocs.map((item) => formatCustomDoc(item, 'docs/custom')).join('\n')]
+      : []),
   ].join('\n');
 
   return new Response(content, {