@eventcatalog/core 3.2.2 → 3.3.0

package/eventcatalog/src/pages/diagrams/[id]/[version].mdx.ts

@@ -0,0 +1,47 @@
+// This file exposes the markdown for diagrams in the URL
+// For example http://localhost:3000/diagrams/target-architecture/1.0.0 loads the Page
+// and http://localhost:3000/diagrams/target-architecture/1.0.0.mdx loads the markdown
+// This is used for LLMs to load the markdown for diagrams (llms.txt)
+
+import type { APIRoute } from 'astro';
+import { getCollection } from 'astro:content';
+import fs from 'fs';
+import { isLLMSTxtEnabled, isSSR } from '@utils/feature';
+
+const diagrams = await getCollection('diagrams');
+
+export async function getStaticPaths() {
+  // Just return empty array if LLMs are not enabled
+  if (!isLLMSTxtEnabled()) {
+    return [];
+  }
+
+  return diagrams.map((diagram) => ({
+    params: { id: diagram.data.id, version: diagram.data.version },
+    props: { content: diagram },
+  }));
+}
+
+export const GET: APIRoute = async ({ params, props }) => {
+  // Just return empty array if LLMs are not enabled
+  if (!isLLMSTxtEnabled()) {
+    return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
+  }
+
+  if (isSSR()) {
+    // For SSR mode, find the diagram and read its file
+    const diagram = diagrams.find((d) => d.data.id === params.id && d.data.version === params.version);
+    if (!diagram?.filePath) {
+      return new Response('Not found', { status: 404 });
+    }
+    const file = fs.readFileSync(diagram.filePath, 'utf8');
+    return new Response(file, { status: 200 });
+  } else {
+    if (props?.content?.filePath) {
+      const file = fs.readFileSync(props.content.filePath, 'utf8');
+      return new Response(file, { status: 200 });
+    }
+  }
+
+  return new Response('Not found', { status: 404 });
+};

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/index.astro

@@ -305,6 +305,7 @@ nodeGraphs.push({
                   markdownDownloadEnabled={isMarkdownDownloadEnabled()}
                   rssFeedEnabled={isRSSEnabled()}
                   editUrl={editUrl}
+                  preferChatAsDefault={isEventCatalogChatEnabled()}
                 />
               </div>
             </div>

package/eventcatalog/src/pages/docs/[type]/[id]/[version].md.ts

@@ -7,6 +7,7 @@ import { getCollection } from 'astro:content';
 import { getEntities } from '@utils/collections/entities';
 import config from '@config';
 import fs from 'fs';
+import { isLLMSTxtEnabled } from '@utils/feature';
 
 const events = await getCollection('events');
 const commands = await getCollection('commands');
@@ -19,7 +20,7 @@ const containers = await getCollection('containers');
 const entities = await getEntities();
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return [];
   }
 
@@ -46,7 +47,7 @@ export async function getStaticPaths() {
 
 export const GET: APIRoute = async ({ params, props }) => {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 

package/eventcatalog/src/pages/docs/[type]/[id]/[version].mdx.ts

@@ -21,7 +21,7 @@ import utils from '@eventcatalog/sdk';
 
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return [];
   }
   const collections = {
@@ -45,11 +45,15 @@ export async function getStaticPaths() {
 }
 
 export const GET: APIRoute = async ({ params, props }) => {
+  console.log('props', props);
+
   // Just return empty array if LLMs are not enabled
   if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
+  console.log('params', params);
+
   if (isSSR()) {
     const { getResourcePath } = utils(process.env.PROJECT_DIR ?? '');
     const filePath = await getResourcePath(process.env.PROJECT_DIR ?? '', params.id ?? '', params.version ?? '');

package/eventcatalog/src/pages/docs/[type]/[id]/language.mdx.ts

@@ -3,6 +3,7 @@ import type { CollectionEntry } from 'astro:content';
 import type { APIRoute } from 'astro';
 import config from '@config';
 import fs from 'fs';
+import { isLLMSTxtEnabled } from '@utils/feature';
 
 export async function getStaticPaths() {
   const domains = await getDomains({ getAllVersions: false });
@@ -25,7 +26,7 @@ export async function getStaticPaths() {
 
 export const GET: APIRoute = async ({ params, props }) => {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 

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

@@ -4,8 +4,8 @@
 
 import type { APIRoute, GetStaticPaths } from 'astro';
 import { getCollection } from 'astro:content';
-import config from '@config';
 import fs from 'fs';
+import { isLLMSTxtEnabled } from '@utils/feature';
 
 export const getStaticPaths = (async () => {
   const docs = await getCollection('customPages');
@@ -19,7 +19,7 @@ export const getStaticPaths = (async () => {
 
 export const GET: APIRoute = async ({ params, props }) => {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 

package/eventcatalog/src/pages/docs/teams/[id].md.ts

@@ -6,12 +6,13 @@ import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
 import config from '@config';
 import fs from 'fs';
+import { isLLMSTxtEnabled } from '@utils/feature';
 
 const teams = await getCollection('teams');
 
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return [];
   }
 
@@ -23,7 +24,7 @@ export async function getStaticPaths() {
 
 export const GET: APIRoute = async ({ params, props }) => {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 

package/eventcatalog/src/pages/docs/teams/[id].mdx.ts

@@ -4,14 +4,14 @@
 
 import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
-import config from '@config';
+import { isLLMSTxtEnabled } from '@utils/feature';
 import fs from 'fs';
 
 const teams = await getCollection('teams');
 
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return [];
   }
 
@@ -23,7 +23,7 @@ export async function getStaticPaths() {
 
 export const GET: APIRoute = async ({ params, props }) => {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 

package/eventcatalog/src/pages/docs/users/[id].md.ts

@@ -6,12 +6,13 @@ import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
 import config from '@config';
 import fs from 'fs';
+import { isLLMSTxtEnabled } from '@utils/feature';
 
 const users = await getCollection('users');
 
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return [];
   }
 
@@ -23,7 +24,7 @@ export async function getStaticPaths() {
 
 export const GET: APIRoute = async ({ params, props }) => {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 

package/eventcatalog/src/pages/docs/users/[id].mdx.ts

@@ -4,14 +4,14 @@
 
 import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
-import config from '@config';
+import { isLLMSTxtEnabled } from '@utils/feature';
 import fs from 'fs';
 
 const users = await getCollection('users');
 
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return [];
   }
 
@@ -23,7 +23,7 @@ export async function getStaticPaths() {
 
 export const GET: APIRoute = async ({ params, props }) => {
   // Just return empty array if LLMs are not enabled
-  if (!config.llmsTxt?.enabled) {
+  if (!isLLMSTxtEnabled()) {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 

package/eventcatalog/src/stores/sidebar-store/builders/container.ts

@@ -1,16 +1,21 @@
 import type { CollectionEntry } from 'astro:content';
 import { buildUrl } from '@utils/url-builder';
-import type { NavNode, ChildRef } from './shared';
+import type { NavNode, ChildRef, ResourceGroupContext } from './shared';
 import {
   buildQuickReferenceSection,
   buildOwnersSection,
   shouldRenderSideBarSection,
   buildRepositorySection,
   buildAttachmentsSection,
+  buildDiagramNavItems,
 } from './shared';
 import { isVisualiserEnabled } from '@utils/feature';
 
-export const buildContainerNode = (container: CollectionEntry<'containers'>, owners: any[]): NavNode => {
+export const buildContainerNode = (
+  container: CollectionEntry<'containers'>,
+  owners: any[],
+  context: ResourceGroupContext
+): NavNode => {
   const servicesWritingToContainer = container.data.servicesThatWriteToContainer || [];
   const servicesReadingFromContainer = container.data.servicesThatReadFromContainer || [];
 
@@ -27,6 +32,11 @@ export const buildContainerNode = (container: CollectionEntry<'containers'>, own
 
   const renderRepository = container.data.repository && shouldRenderSideBarSection(container, 'repository');
 
+  // Diagrams
+  const containerDiagrams = container.data.diagrams || [];
+  const diagramNavItems = buildDiagramNavItems(containerDiagrams, context.diagrams);
+  const hasDiagrams = diagramNavItems.length > 0;
+
   return {
     type: 'item',
     title: container.data.name,
@@ -41,16 +51,22 @@ export const buildContainerNode = (container: CollectionEntry<'containers'>, own
       ]),
       renderVisualiser && {
         type: 'group',
-        title: 'Architecture & Design',
+        title: 'Architecture',
         icon: 'Workflow',
         pages: [
           {
             type: 'item',
-            title: 'Interaction Map',
+            title: 'Map',
             href: buildUrl(`/visualiser/containers/${container.data.id}/${container.data.version}`),
           },
         ],
       },
+      hasDiagrams && {
+        type: 'group',
+        title: 'Diagrams',
+        icon: 'FileImage',
+        pages: diagramNavItems,
+      },
       renderServicesWritingToContainer && {
         type: 'group',
         title: 'Services (Writes)',

package/eventcatalog/src/stores/sidebar-store/builders/domain.ts

@@ -8,6 +8,7 @@ import {
   shouldRenderSideBarSection,
   buildRepositorySection,
   buildAttachmentsSection,
+  buildDiagramNavItems,
 } from './shared';
 import { isVisualiserEnabled } from '@utils/feature';
 
@@ -35,6 +36,12 @@ export const buildDomainNode = (domain: CollectionEntry<'domains'>, owners: any[
   const hasAttachments = domain.data.attachments && domain.data.attachments.length > 0;
 
   const renderRepository = domain.data.repository && shouldRenderSideBarSection(domain, 'repository');
+
+  // Diagrams
+  const domainDiagrams = domain.data.diagrams || [];
+  const diagramNavItems = buildDiagramNavItems(domainDiagrams, context.diagrams);
+  const hasDiagrams = diagramNavItems.length > 0;
+
   return {
     type: 'item',
     title: domain.data.name,
@@ -47,32 +54,33 @@ export const buildDomainNode = (domain: CollectionEntry<'domains'>, owners: any[
       ]),
       {
         type: 'group',
-        title: 'Architecture & Design',
+        title: 'Architecture',
         icon: 'Workflow',
         pages: [
           {
             type: 'item',
-            title: 'Architecture Overview',
+            title: 'Overview',
             href: buildUrl(`/architecture/domains/${domain.data.id}/${domain.data.version}`),
           },
+          renderVisualiser && {
+            type: 'item',
+            title: 'Map',
+            href: buildUrl(`/visualiser/domains/${domain.data.id}/${domain.data.version}`),
+          },
           renderEntities &&
             renderVisualiser && {
               type: 'item',
               title: 'Entity Map',
               href: buildUrl(`/visualiser/domains/${domain.data.id}/${domain.data.version}/entity-map`),
             },
-          renderVisualiser && {
-            type: 'item',
-            title: 'Interaction Map',
-            href: buildUrl(`/visualiser/domains/${domain.data.id}/${domain.data.version}`),
-          },
-          renderVisualiser && {
-            type: 'item',
-            title: 'Global Domain Map',
-            href: buildUrl(`/visualiser/domain-integrations`),
-          },
         ].filter(Boolean) as ChildRef[],
       },
+      hasDiagrams && {
+        type: 'group',
+        title: 'Diagrams',
+        icon: 'FileImage',
+        pages: diagramNavItems,
+      },
       renderSubDomains && {
         type: 'group',
         title: 'Subdomains',

package/eventcatalog/src/stores/sidebar-store/builders/flow.ts

@@ -14,7 +14,7 @@ export const buildFlowNode = (flow: CollectionEntry<'flows'>): NavNode => {
       buildQuickReferenceSection([{ title: 'Overview', href: buildUrl(`/docs/flows/${flow.data.id}/${flow.data.version}`) }]),
       {
         type: 'group',
-        title: 'Architecture & Design',
+        title: 'Architecture',
         icon: 'Workflow',
         pages: [
           {

package/eventcatalog/src/stores/sidebar-store/builders/message.ts

@@ -1,17 +1,22 @@
 import type { CollectionEntry } from 'astro:content';
 import { buildUrl } from '@utils/url-builder';
 import { getSchemaFormatFromURL } from '@utils/collections/schemas';
-import type { NavNode, ChildRef } from './shared';
+import type { NavNode, ChildRef, ResourceGroupContext } from './shared';
 import {
   buildQuickReferenceSection,
   buildOwnersSection,
   shouldRenderSideBarSection,
   buildRepositorySection,
   buildAttachmentsSection,
+  buildDiagramNavItems,
 } from './shared';
 import { isVisualiserEnabled } from '@utils/feature';
 
-export const buildMessageNode = (message: CollectionEntry<'events' | 'commands' | 'queries'>, owners: any[]): NavNode => {
+export const buildMessageNode = (
+  message: CollectionEntry<'events' | 'commands' | 'queries'>,
+  owners: any[],
+  context: ResourceGroupContext
+): NavNode => {
   const producers = message.data.producers || [];
   const consumers = message.data.consumers || [];
   const collection = message.collection;
@@ -35,6 +40,11 @@ export const buildMessageNode = (message: CollectionEntry<'events' | 'commands'
 
   const renderOwners = owners.length > 0 && shouldRenderSideBarSection(message, 'owners');
 
+  // Diagrams
+  const messageDiagrams = message.data.diagrams || [];
+  const diagramNavItems = buildDiagramNavItems(messageDiagrams, context.diagrams);
+  const hasDiagrams = diagramNavItems.length > 0;
+
   return {
     type: 'item',
     title: message.data.name,
@@ -49,16 +59,22 @@ export const buildMessageNode = (message: CollectionEntry<'events' | 'commands'
       ]),
       renderVisualiser && {
         type: 'group',
-        title: 'Architecture & Design',
+        title: 'Architecture',
         icon: 'Workflow',
         pages: [
           {
             type: 'item',
-            title: 'Interaction Map',
+            title: 'Map',
             href: buildUrl(`/visualiser/${collection}/${message.data.id}/${message.data.version}`),
           },
         ],
       },
+      hasDiagrams && {
+        type: 'group',
+        title: 'Diagrams',
+        icon: 'FileImage',
+        pages: diagramNavItems,
+      },
       hasSchema && {
         type: 'group',
         title: `API & Contracts`,

package/eventcatalog/src/stores/sidebar-store/builders/service.ts

@@ -1,7 +1,7 @@
 import type { CollectionEntry } from 'astro:content';
 import { buildUrl } from '@utils/url-builder';
 import { getSpecificationsForService } from '@utils/collections/services';
-import type { NavNode, ChildRef } from './shared';
+import type { NavNode, ChildRef, ResourceGroupContext } from './shared';
 import {
   uniqueBy,
   buildQuickReferenceSection,
@@ -10,11 +10,12 @@ import {
   buildResourceGroupSections,
   buildRepositorySection,
   buildAttachmentsSection,
+  buildDiagramNavItems,
 } from './shared';
 import { isVisualiserEnabled } from '@utils/feature';
 import { pluralizeMessageType } from '@utils/collections/messages';
 
-export const buildServiceNode = (service: CollectionEntry<'services'>, owners: any[], context: any): NavNode => {
+export const buildServiceNode = (service: CollectionEntry<'services'>, owners: any[], context: ResourceGroupContext): NavNode => {
   const sendsMessages = service.data.sends || [];
   const receivesMessages = service.data.receives || [];
   const serviceEntities = service.data.entities || [];
@@ -44,6 +45,11 @@ export const buildServiceNode = (service: CollectionEntry<'services'>, owners: a
   const renderOwners = owners.length > 0 && shouldRenderSideBarSection(service, 'owners');
   const renderRepository = service.data.repository && shouldRenderSideBarSection(service, 'repository');
 
+  // Diagrams
+  const serviceDiagrams = service.data.diagrams || [];
+  const diagramNavItems = buildDiagramNavItems(serviceDiagrams, context.diagrams);
+  const hasDiagrams = diagramNavItems.length > 0;
+
   return {
     type: 'item',
     title: service.data.name,
@@ -55,17 +61,17 @@ export const buildServiceNode = (service: CollectionEntry<'services'>, owners: a
       ]),
       {
         type: 'group',
-        title: 'Architecture & Design',
+        title: 'Architecture',
         icon: 'Workflow',
         pages: [
           {
             type: 'item',
-            title: 'Architecture Overview',
+            title: 'Overview',
             href: buildUrl(`/architecture/services/${service.data.id}/${service.data.version}`),
           },
           renderVisualiser && {
             type: 'item',
-            title: 'Interaction Map',
+            title: 'Map',
             href: buildUrl(`/visualiser/services/${service.data.id}/${service.data.version}`),
           },
           renderVisualiser &&
@@ -74,7 +80,13 @@ export const buildServiceNode = (service: CollectionEntry<'services'>, owners: a
               title: 'Data Map',
               href: buildUrl(`/visualiser/services/${service.data.id}/${service.data.version}/data`),
             },
-        ],
+        ].filter(Boolean) as ChildRef[],
+      },
+      hasDiagrams && {
+        type: 'group',
+        title: 'Diagrams',
+        icon: 'FileImage',
+        pages: diagramNavItems,
       },
       renderSpecifications && {
         type: 'group',

package/eventcatalog/src/stores/sidebar-store/builders/shared.ts

@@ -54,6 +54,7 @@ export type ResourceGroupContext = {
   queries: CollectionEntry<'queries'>[];
   flows: CollectionEntry<'flows'>[];
   containers: CollectionEntry<'containers'>[];
+  diagrams: CollectionEntry<'diagrams'>[];
 };
 
 export const buildQuickReferenceSection = (items: { title: string; href: string }[]): NavNode => ({
@@ -158,3 +159,22 @@ export const shouldRenderSideBarSection = (resource: any, section: string) => {
   }
   return resource.data.detailsPanel[section]?.visible ?? true;
 };
+
+export const buildDiagramNavItems = (
+  diagrams: Array<{ id: string; version?: string }> | undefined,
+  allDiagrams: CollectionEntry<'diagrams'>[]
+): NavNode[] => {
+  if (!diagrams || diagrams.length === 0) return [];
+
+  return diagrams.map((ref) => {
+    const diagram = allDiagrams.find(
+      (d) => d.data.id === ref.id && (ref.version === 'latest' || !ref.version || d.data.version === ref.version)
+    );
+    const version = diagram?.data.version || ref.version || 'latest';
+    return {
+      type: 'item' as const,
+      title: diagram?.data.name || ref.id,
+      href: buildUrl(`/diagrams/${ref.id}/${version}`),
+    };
+  });
+};

package/eventcatalog/src/stores/sidebar-store/state.ts

@@ -6,6 +6,7 @@ import { getOwner } from '@utils/collections/owners';
 import { getFlows } from '@utils/collections/flows';
 import { getUsers } from '@utils/collections/users';
 import { getTeams } from '@utils/collections/teams';
+import { getDiagrams } from '@utils/collections/diagrams';
 import { buildUrl } from '@utils/url-builder';
 import type { NavigationData, NavNode, ChildRef } from './builders/shared';
 import { buildDomainNode } from './builders/domain';
@@ -30,7 +31,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     return memoryCache;
   }
 
-  const [domains, services, { events, commands, queries }, containers, flows, users, teams, designs, channels] =
+  const [domains, services, { events, commands, queries }, containers, flows, users, teams, designs, channels, diagrams] =
     await Promise.all([
       getDomains({ getAllVersions: false, includeServicesInSubdomains: false }),
       getServices({ getAllVersions: false }),
@@ -41,6 +42,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
       getTeams(),
       getDesigns(),
       getChannels({ getAllVersions: false }),
+      getDiagrams({ getAllVersions: false }),
     ]);
 
   // Calculate derived lists to avoid extra fetches
@@ -57,6 +59,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     queries,
     flows,
     containers,
+    diagrams,
   };
 
   // Process all domains with their owners first (async)
@@ -136,9 +139,9 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     (acc, { message, owners }) => {
       const type = pluralizeMessageType(message as any);
 
-      acc[`${type}:${message.data.id}:${message.data.version}`] = buildMessageNode(message, owners);
+      acc[`${type}:${message.data.id}:${message.data.version}`] = buildMessageNode(message, owners, context);
       if (message.data.latestVersion === message.data.version) {
-        acc[`${type}:${message.data.id}`] = buildMessageNode(message, owners);
+        acc[`${type}:${message.data.id}`] = buildMessageNode(message, owners, context);
       }
       return acc;
     },
@@ -147,9 +150,9 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
 
   const containerNodes = containerWithOwners.reduce(
     (acc, { container, owners }) => {
-      acc[`container:${container.data.id}:${container.data.version}`] = buildContainerNode(container, owners);
+      acc[`container:${container.data.id}:${container.data.version}`] = buildContainerNode(container, owners, context);
       if (container.data.latestVersion === container.data.version) {
-        acc[`container:${container.data.id}`] = buildContainerNode(container, owners);
+        acc[`container:${container.data.id}`] = buildContainerNode(container, owners, context);
       }
       return acc;
     },
@@ -383,6 +386,25 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     ...(allList ? { 'list:all': allList as NavNode } : {}),
   };
 
+  // System-level views (only show if visualiser is enabled and there are domains)
+  const systemNode: Record<string, NavNode> = {};
+  const visualiserEnabled = config?.visualiser?.enabled !== false;
+
+  if (visualiserEnabled && domains.length > 0) {
+    systemNode['list:system'] = {
+      type: 'group',
+      title: 'System',
+      icon: 'Globe',
+      pages: [
+        {
+          type: 'item',
+          title: 'Domain Map',
+          href: buildUrl('/visualiser/domain-integrations'),
+        },
+      ],
+    };
+  }
+
   const allGeneratedNodes = {
     ...rootDomainsNodes,
     ...domainNodes,
@@ -394,11 +416,17 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     ...userNodes,
     ...teamNodes,
     ...designNodes,
+    ...systemNode,
     ...allNodes,
   };
 
   // only filter if child is string
-  const rootNavigationConfig = config?.navigation?.pages || ['list:top-level-domains', 'list:all'];
+  const defaultPages = ['list:top-level-domains', 'list:all'];
+  // Add system section if it exists
+  if (systemNode['list:system']) {
+    defaultPages.push('list:system');
+  }
+  const rootNavigationConfig = config?.navigation?.pages || defaultPages;
 
   const navigationConfig = {
     roots: rootNavigationConfig,

package/eventcatalog/src/types/index.ts

@@ -7,7 +7,8 @@ export type CollectionTypes =
   | 'flows'
   | 'channels'
   | 'entities'
-  | 'containers';
+  | 'containers'
+  | 'diagrams';
 export type CollectionMessageTypes = 'commands' | 'events' | 'queries';
 export type CollectionUserTypes = 'users';
 export type PageTypes =
@@ -19,7 +20,8 @@ export type PageTypes =
   | 'channels'
   | 'flows'
   | 'entities'
-  | 'containers';
+  | 'containers'
+  | 'diagrams';
 
 export type TableConfiguration = {
   columns: {