@eventcatalog/core 4.11.2 → 4.12.0-beta.1

package/eventcatalog/src/enterprise/fields/pages/api/fields.ts

@@ -6,10 +6,11 @@
 import type { APIRoute } from 'astro';
 import { Hono } from 'hono';
 import { getFieldsDatabase } from '@enterprise/fields/fields-db';
-import path from 'node:path';
+import { getRuntimePaths } from '../../../../../integrations/runtime-paths.mjs';
 
-const catalogDirectory = process.env.CATALOG_DIR || process.cwd();
-const dbPath = path.join(catalogDirectory, '.eventcatalog', 'fields.db');
+// The CLI builds the index at this same path. Shipping it with dist-only SSR
+// deployments is a separate artifact-lifecycle issue, not solved by a fallback.
+const { fieldsDatabasePath: dbPath } = getRuntimePaths(process.env.PROJECT_DIR || process.cwd(), process.env.CATALOG_DIR);
 
 const app = new Hono().basePath('/api/schemas/fields');
 

package/eventcatalog/src/enterprise/integrations/eventcatalog-features.ts

@@ -6,7 +6,10 @@
 import type { AstroIntegration } from 'astro';
 import fs from 'node:fs';
 import path from 'path';
-import config from '../../../eventcatalog.config.js';
+import { fileURLToPath } from 'node:url';
+import { getRuntimePaths } from '../../../integrations/runtime-paths.mjs';
+// This integration runs during Astro config evaluation, before @config exists.
+import config from '../../utils/eventcatalog-config/source';
 import {
   isEventCatalogChatEnabled,
   isAuthEnabled,
@@ -20,22 +23,17 @@ import {
   isCustomPagesEnabled,
   isSSR,
 } from '../../utils/feature';
-import {
-  CUSTOM_PAGES_MANIFEST_FILENAME,
-  getCustomPageRoutes,
-  isApiRoute,
-  listCustomPageFiles,
-  resolveCustomPagesPrefix,
-} from '../custom-pages/routes';
+import { getCustomPageRoutes, isApiRoute, listCustomPageFiles, resolveCustomPagesPrefix } from '../custom-pages/routes';
 
-const catalogDirectory = process.env.CATALOG_DIR || process.cwd();
-const customPagesDirectory = path.join(catalogDirectory, 'src/custom-pages');
+const { runtimeDirectory: catalogDirectory } = getRuntimePaths(process.env.PROJECT_DIR || process.cwd(), process.env.CATALOG_DIR);
+const packageDirectory = fileURLToPath(new URL('../../../', import.meta.url));
+const customPagesDirectory = path.join(process.env.PROJECT_DIR || process.cwd(), 'pages');
 
 // Routes are injected at astro:config:setup, so adding or removing a custom page
 // file needs a full Astro restart before its route exists. This manifest is
 // registered via addWatchFile — rewriting it with a changed file list triggers
 // that restart (a Vite-level server.restart() does NOT re-run route injection).
-const customPagesManifest = path.join(customPagesDirectory, CUSTOM_PAGES_MANIFEST_FILENAME);
+const customPagesManifest = path.join(catalogDirectory, 'custom-pages.json');
 
 const writeCustomPagesManifest = () => {
   const content = JSON.stringify(listCustomPageFiles(customPagesDirectory));
@@ -45,7 +43,7 @@ const writeCustomPagesManifest = () => {
       return;
     }
 
-    fs.mkdirSync(customPagesDirectory, { recursive: true });
+    fs.mkdirSync(catalogDirectory, { recursive: true });
     fs.writeFileSync(customPagesManifest, content);
   } catch (error: any) {
     console.warn(`[EventCatalog] Could not update the custom pages manifest: ${error.message}`);
@@ -85,25 +83,25 @@ const configureAuthentication = (params: {
 }) => {
   params.injectRoute({
     pattern: '/api/[...auth]',
-    entrypoint: path.join(catalogDirectory, 'src/enterprise/auth/[...auth].ts'),
+    entrypoint: path.join(packageDirectory, 'src/enterprise/auth/[...auth].ts'),
   });
   params.injectRoute({
     pattern: '/auth/login',
-    entrypoint: path.join(catalogDirectory, 'src/enterprise/auth/login.astro'),
+    entrypoint: path.join(packageDirectory, 'src/enterprise/auth/login.astro'),
   });
   params.injectRoute({
     pattern: '/auth/error',
-    entrypoint: path.join(catalogDirectory, 'src/enterprise/auth/error.astro'),
+    entrypoint: path.join(packageDirectory, 'src/enterprise/auth/error.astro'),
   });
 
   params.injectRoute({
     pattern: '/unauthorized',
-    entrypoint: path.join(catalogDirectory, 'src/enterprise/auth/unauthorized.astro'),
+    entrypoint: path.join(packageDirectory, 'src/enterprise/auth/unauthorized.astro'),
   });
 
   // Add the authentication middleware
   params.addMiddleware({
-    entrypoint: path.join(catalogDirectory, 'src/enterprise/auth/middleware/middleware.ts'),
+    entrypoint: path.join(packageDirectory, 'src/enterprise/auth/middleware/middleware.ts'),
     order: 'pre',
   });
 };
@@ -117,7 +115,7 @@ export default function eventCatalogIntegration(): AstroIntegration {
         if (isEventCatalogChatEnabled()) {
           params.injectRoute({
             pattern: '/api/chat',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/ai/chat-api.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/ai/chat-api.ts'),
           });
         }
 
@@ -125,18 +123,18 @@ export default function eventCatalogIntegration(): AstroIntegration {
         if (isEventCatalogMCPEnabled()) {
           params.injectRoute({
             pattern: '/docs/mcp/[...path]',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/mcp/mcp-server.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/mcp/mcp-server.ts'),
           });
         }
 
         if (isEventCatalogMCPAuthEnabled()) {
           params.injectRoute({
             pattern: '/.well-known/oauth-protected-resource',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/mcp/oauth-protected-resource.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/mcp/oauth-protected-resource.ts'),
           });
           params.injectRoute({
             pattern: '/.well-known/oauth-protected-resource/[...path]',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/mcp/oauth-protected-resource.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/mcp/oauth-protected-resource.ts'),
           });
         }
 
@@ -149,24 +147,24 @@ export default function eventCatalogIntegration(): AstroIntegration {
         if (isCustomDocsEnabled()) {
           params.injectRoute({
             pattern: '/docs/custom',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/custom-documentation/pages/docs/custom/root-index.astro'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/custom-documentation/pages/docs/custom/root-index.astro'),
           });
           params.injectRoute({
             pattern: '/docs/custom/[...path]',
             entrypoint: path.join(
-              catalogDirectory,
+              packageDirectory,
               'src/enterprise/custom-documentation/pages/docs/custom/[...path]/index.astro'
             ),
           });
           params.injectRoute({
             pattern: '/docs/custom/[...path].mdx',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/custom-documentation/pages/docs/custom/[...path].mdx.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/custom-documentation/pages/docs/custom/[...path].mdx.ts'),
           });
         } else {
           // Show feature page for non-paying users
           params.injectRoute({
             pattern: '/docs/custom',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/custom-documentation/pages/docs/custom/feature.astro'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/custom-documentation/pages/docs/custom/feature.astro'),
           });
         }
 
@@ -174,12 +172,12 @@ export default function eventCatalogIntegration(): AstroIntegration {
         if (isEventCatalogScaleEnabled()) {
           params.injectRoute({
             pattern: '/api/schemas/[collection]/[id]/[version]',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/api/schemas/[collection]/[id]/[version]/index.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/api/schemas/[collection]/[id]/[version]/index.ts'),
           });
           params.injectRoute({
             pattern: '/api/schemas/services/[id]/[version]/[specification]',
             entrypoint: path.join(
-              catalogDirectory,
+              packageDirectory,
               'src/enterprise/api/schemas/services/[id]/[version]/[specification]/index.ts'
             ),
           });
@@ -189,7 +187,7 @@ export default function eventCatalogIntegration(): AstroIntegration {
         if (isFullCatalogAPIEnabled()) {
           params.injectRoute({
             pattern: '/api/catalog',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/api/catalog.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/api/catalog.ts'),
           });
         }
 
@@ -197,11 +195,11 @@ export default function eventCatalogIntegration(): AstroIntegration {
         if (isSSR()) {
           params.injectRoute({
             pattern: '/schemas/fields',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/fields/pages/fields.astro'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/fields/pages/fields.astro'),
           });
           params.injectRoute({
             pattern: '/api/schemas/fields',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/fields/pages/api/fields.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/fields/pages/api/fields.ts'),
           });
         }
 
@@ -226,11 +224,11 @@ export default function eventCatalogIntegration(): AstroIntegration {
         if (isDevMode()) {
           params.injectRoute({
             pattern: '/api/dev/visualizer-layout/save',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/visualizer-layout/save.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/visualizer-layout/save.ts'),
           });
           params.injectRoute({
             pattern: '/api/dev/visualizer-layout/reset',
-            entrypoint: path.join(catalogDirectory, 'src/enterprise/visualizer-layout/reset.ts'),
+            entrypoint: path.join(packageDirectory, 'src/enterprise/visualizer-layout/reset.ts'),
           });
         }
       },
@@ -247,6 +245,8 @@ export default function eventCatalogIntegration(): AstroIntegration {
 
         server.watcher.on('add', onCustomPageChange);
         server.watcher.on('unlink', onCustomPageChange);
+        server.watcher.add(customPagesDirectory);
+        server.watcher.add(customPagesManifest);
       },
     },
   };

package/eventcatalog/src/enterprise/mcp/mcp-auth.ts

@@ -5,7 +5,7 @@
 
 import jwt, { type Algorithm, type JwtPayload } from 'jsonwebtoken';
 import { createPublicKey, type JsonWebKey, type KeyObject } from 'node:crypto';
-import config from '../../../eventcatalog.config.js';
+import config from '@config';
 import type { Config } from '../../../../src/eventcatalog.config';
 
 type ConfiguredMcpAuth = NonNullable<NonNullable<Config['mcp']>['auth']>;

package/eventcatalog/src/env.d.ts

@@ -1,10 +1,16 @@
-/// <reference path="../.astro/types.d.ts" />
 /// <reference types="astro/client" />
 
 declare const __EC_TRAILING_SLASH__: boolean;
 declare const __EC_BASE__: string;
 declare const __EC_SEARCH_TYPE__: 'resource' | 'indexed';
 
+declare module '@catalog/styles';
+
+declare module 'virtual:eventcatalog/homepage' {
+  const homepage: any;
+  export default homepage;
+}
+
 declare module 'virtual:likec4-projects' {
   export const projectRegistry: Record<string, () => Promise<{ LikeC4View: import('react').ComponentType<any> }>>;
   export const discoveredProjects: string[];

package/eventcatalog/src/layouts/VerticalSideBarLayout.astro

@@ -86,7 +86,7 @@ let dataProducts: any[] = [];
 // Try and load any custom styles if they exist
 if (isCustomStylesEnabled()) {
   try {
-    await import('../../eventcatalog.styles.css');
+    await import('@catalog/styles');
   } catch (error) {}
 }
 
@@ -497,13 +497,25 @@ const verticalNavAutoCollapsePaths = [buildUrl('/discover', true), buildUrl('/do
       }
 
       .app-content-wrapper {
-        --ec-app-content-padding-left: 5rem;
-        --ec-app-content-padding-right: 5rem;
+        --ec-app-content-padding-left: 1.5rem;
+        --ec-app-content-padding-right: 1.5rem;
         margin-left: auto;
         margin-right: auto;
         padding-left: var(--ec-app-content-padding-left);
         padding-right: var(--ec-app-content-padding-right);
       }
+      @media (min-width: 768px) {
+        .app-content-wrapper {
+          --ec-app-content-padding-left: 2.5rem;
+          --ec-app-content-padding-right: 2.5rem;
+        }
+      }
+      @media (min-width: 1280px) {
+        .app-content-wrapper {
+          --ec-app-content-padding-left: 3.5rem;
+          --ec-app-content-padding-right: 2rem;
+        }
+      }
       .app-content-wrapper--reduced-padding {
         --ec-app-content-padding-left: 2rem;
         --ec-app-content-padding-right: 2rem;

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

@@ -24,7 +24,7 @@ const specifications = type === 'services' ? getSpecificationsForService(props)
 <VerticalSideBarLayout title={pageTitle}>
   <main class="flex docs-layout min-h-full bg-[rgb(var(--ec-page-bg))]">
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         {type === 'domains' && <DomainGrid domain={domain} client:load />}
         {type === 'systems' && <SystemGrid system={props} client:load />}
         {

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

@@ -32,7 +32,7 @@ const chatQuery = `Tell me about the "${props.data.name}" diagram (version ${pro
       class="flex docs-layout w-full"
       style="padding-left: var(--ec-app-content-padding-left, 5rem); padding-right: var(--ec-app-content-padding-right, 5rem);"
     >
-      <main class="diagram-content w-full lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <main class="diagram-content w-full lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-2">
           <div class="flex items-start gap-4">
             <div class="min-w-0">
@@ -73,7 +73,7 @@ const chatQuery = `Tell me about the "${props.data.name}" diagram (version ${pro
         headings.length > 0 && (
           <aside
             id="eventcatalog-docs-sidebar"
-            class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-10 bg-[rgb(var(--ec-page-bg))]"
+            class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-4 bg-[rgb(var(--ec-page-bg))]"
           >
             <div class="mt-8 space-y-8">
               <div>

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

@@ -52,7 +52,7 @@ const pagefindAttributes =
 <VerticalSideBarLayout title={pageTitle} description={props.data.summary}>
   <main class="flex docs-layout min-h-full bg-[rgb(var(--ec-page-bg))]" {...pagefindAttributes}>
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         {/* Header mirrors the latest-doc page ([docId]/index.astro) and the resource page. */}
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-3 pt-4">
           <div class="flex flex-col gap-4">
@@ -108,7 +108,7 @@ const pagefindAttributes =
         </div>
       </div>
       <aside
-        class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-10 bg-[rgb(var(--ec-page-bg))]"
+        class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-4 bg-[rgb(var(--ec-page-bg))]"
       >
         <div class="mt-8 space-y-8">
           <h3 class="text-xs text-[rgb(var(--ec-page-text))] font-semibold capitalize flex items-center gap-2 mb-4">

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

@@ -53,7 +53,7 @@ const pagefindAttributes =
 <VerticalSideBarLayout title={pageTitle} description={props.data.summary}>
   <main class="flex docs-layout min-h-full bg-[rgb(var(--ec-page-bg))]" {...pagefindAttributes}>
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         {/* Header mirrors the resource page (docs/[type]/[id]/[version]/index.astro) so docs feel like part of the resource. */}
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-3 pt-4">
           <div class="flex flex-col gap-4">
@@ -107,7 +107,7 @@ const pagefindAttributes =
         </div>
       </div>
       <aside
-        class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-10 bg-[rgb(var(--ec-page-bg))]"
+        class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-4 bg-[rgb(var(--ec-page-bg))]"
       >
         <div class="mt-8 space-y-8">
           <h3 class="text-xs text-[rgb(var(--ec-page-text))] font-semibold capitalize flex items-center gap-2 mb-4">

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

@@ -66,7 +66,7 @@ const pagefindAttributes =
 <VerticalSideBarLayout title={pageTitle} description={`GraphQL schema for ${data.name}`}>
   <main class="flex docs-layout min-h-full bg-[rgb(var(--ec-page-bg))]" {...pagefindAttributes}>
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-2">
           <div>
             <div class="flex justify-between items-start">

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

@@ -424,7 +424,7 @@ if (!isAdrPage && !hasCurrentFlowEmbed && !hasCurrentPageNodeGraph) {
 <VerticalSideBarLayout title={pageTitle} description={props.data.summary}>
   <main class="flex docs-layout min-h-full bg-[rgb(var(--ec-page-bg))]" {...pagefindAttributes}>
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-3 pt-4">
           <div>
             <div>
@@ -715,7 +715,7 @@ if (!isAdrPage && !hasCurrentFlowEmbed && !hasCurrentPageNodeGraph) {
       </div>
       <aside
         id="eventcatalog-docs-sidebar"
-        class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-10 bg-[rgb(var(--ec-page-bg))]"
+        class="hidden xl:block sticky top-[4rem] self-start w-[280px] max-h-[calc(100vh-4rem)] overflow-y-auto py-2 flex-shrink-0 pr-4 bg-[rgb(var(--ec-page-bg))]"
       >
         <div class="mt-8 space-y-8">
           {

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

@@ -47,7 +47,7 @@ const resources: SystemResourceItem[] = resourceGroups.flatMap(({ collection, it
 <VerticalSideBarLayout title={`${data.name} | Resources`}>
   <main class="flex docs-layout min-h-full bg-[rgb(var(--ec-page-bg))]">
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         {/* Header mirrors the resource page (docs/[type]/[id]/[version]/index.astro). */}
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-3 pt-4">
           <div class="flex flex-col gap-4">

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

@@ -55,7 +55,7 @@ const badges = [
     data-pagefind-meta={`title:${pageTitle}`}
   >
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 min-h-[50em]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 min-h-[50em]">
         {/* Header mirrors the resource page (docs/[type]/[id]/[version]/index.astro). */}
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-3 pt-4">
           <div class="flex flex-col gap-4">

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

@@ -33,7 +33,7 @@ const ownerTypeLabel = props.collection === 'domains' ? 'Domain' : 'System';
     data-pagefind-meta={`title:${pageTitle}`}
   >
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 min-h-[50em]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 min-h-[50em]">
         {/* Header mirrors the resource page (docs/[type]/[id]/[version]/index.astro). */}
         <div class="border-b border-[rgb(var(--ec-page-border))] md:pb-3 pt-4">
           <div class="flex flex-col gap-4">

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

@@ -103,7 +103,7 @@ const sourceTitle = sourceLabel ? `Synced from ${sourceLabel}` : undefined;
     data-pagefind-meta={`title:${pageTitle}`}
   >
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         <div class="border-b border-[rgb(var(--ec-page-border))] pb-6">
           <div class="flex justify-start">
             <div class="flex flex-col justify-between space-y-3">
@@ -219,7 +219,7 @@ const sourceTitle = sourceLabel ? `Synced from ${sourceLabel}` : undefined;
         </div>
       </div>
       <aside
-        class="hidden xl:block sticky top-[5.5rem] self-start w-[280px] max-h-[calc(100vh-5.5rem)] overflow-y-auto py-2 flex-shrink-0 pr-10 bg-[rgb(var(--ec-page-bg))]"
+        class="hidden xl:block sticky top-[5.5rem] self-start w-[280px] max-h-[calc(100vh-5.5rem)] overflow-y-auto py-2 flex-shrink-0 pr-4 bg-[rgb(var(--ec-page-bg))]"
         data-pagefind-ignore
       >
         <div class="py-2">

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

@@ -100,7 +100,7 @@ const sourceTitle = sourceLabel ? `Synced from ${sourceLabel}` : undefined;
     data-pagefind-meta={`title:${pageTitle}`}
   >
     <div class="flex docs-layout w-full">
-      <div class="w-full min-w-0 lg:mr-2 pr-24 py-8 bg-[rgb(var(--ec-page-bg))]">
+      <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         <div class="border-b border-[rgb(var(--ec-page-border))] pb-6">
           <div class="flex justify-start gap-6">
             {
@@ -225,7 +225,7 @@ const sourceTitle = sourceLabel ? `Synced from ${sourceLabel}` : undefined;
         </div>
       </div>
       <aside
-        class="hidden xl:block sticky top-[5.5rem] self-start w-[280px] max-h-[calc(100vh-5.5rem)] overflow-y-auto py-2 flex-shrink-0 pr-10 bg-[rgb(var(--ec-page-bg))]"
+        class="hidden xl:block sticky top-[5.5rem] self-start w-[280px] max-h-[calc(100vh-5.5rem)] overflow-y-auto py-2 flex-shrink-0 pr-4 bg-[rgb(var(--ec-page-bg))]"
         data-pagefind-ignore
       >
         <div class="py-2">

package/eventcatalog/src/pages/index.astro

@@ -5,6 +5,7 @@ import { resourceToCollectionMap } from '@utils/collections/util';
 import { buildUrl } from '@utils/url-builder';
 import { isCustomLandingPageEnabled, isVisualiserEnabled, isArchitectureGraphEnabled } from '@utils/feature';
 import DefaultAstroLandingPage from './_index.astro';
+import CustomHomepage from 'virtual:eventcatalog/homepage';
 import config from '@config';
 
 let nodeGraphs: any[] = [];
@@ -23,9 +24,7 @@ const props = Astro.props;
 const pathToUserDefinedLandingPage = path.join(process.env.PROJECT_DIR || '', 'pages/homepage.astro');
 
 if (existsSync(pathToUserDefinedLandingPage) && isCustomLandingPageEnabled()) {
-  const customPages = import.meta.glob('/src/custom-pages/homepage.astro', { eager: true });
-  // @ts-ignore
-  CustomContent = Object.values(customPages)[0]?.default || null;
+  CustomContent = CustomHomepage;
 
   const [{ default: pageComponents }, { default: mdxComponents }] = await Promise.all([
     import('@components/MDX/page-components'),

package/eventcatalog/src/styles/tailwind.css

@@ -1,5 +1,8 @@
 @import 'tailwindcss';
 
+/* Core templates live in the installed package, which automatic scanning skips. */
+@source '../';
+
 @plugin "@tailwindcss/typography";
 
 /*

package/eventcatalog/src/utils/eventcatalog-config/source.ts

@@ -0,0 +1,9 @@
+import { getEventCatalogConfigFile } from '../../../integrations/config-loader.mjs';
+import type { Config } from '../../../../src/eventcatalog.config';
+
+// Astro evaluates its config before Vite aliases exist. During application
+// compilation the runtime integration replaces this module with a static
+// re-export so production output includes the user's configuration.
+const config: Config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || process.cwd());
+
+export default config;

package/eventcatalog/src/utils/feature.ts

@@ -1,4 +1,5 @@
-import config from '../../eventcatalog.config.js';
+// Feature checks also run during Astro config evaluation, before @config exists.
+import config from './eventcatalog-config/source';
 
 // Open-source feature flags
 export const isEventCatalogChatVisible = () => config?.chat?.enabled ?? true;

package/eventcatalog/tsconfig.json

@@ -4,20 +4,17 @@
     "strict": true,
     "baseUrl": ".",
     "paths": {
-      "@config": ["./eventcatalog.config.js"],
+      "@config": ["src/utils/eventcatalog-config/source.ts"],
       "@eventcatalog": ["src/utils/eventcatalog-config/catalog.ts"],
       "@icons/*": ["src/icons/*"],
       "@components/*": ["src/components/*"],
-      "@catalog/components/*": ["src/custom-defined-components/*"],
       "@catalog/layouts/*": ["src/toolkit/layouts/*"],
       "@catalog/utils": ["src/toolkit/utils/index.ts"],
       "@catalog/utils/*": ["src/toolkit/utils/*"],
-      "@catalog/snippets/*": ["src/snippets/*"],
       "@types": ["src/types/index.ts"],
       "@utils/*": ["src/utils/*"],
       "@layouts/*": ["src/layouts/*"],
       "@enterprise/*": ["src/enterprise/*"],
-      "@ai/*": ["src/generated-ai/*"],
       "auth:config": ["./auth.config.ts"],
       "@stores/*": ["src/stores/*"]
     },

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "4.11.2",
+  "version": "4.12.0-beta.1",
   "publishConfig": {
     "access": "public"
   },
@@ -28,6 +28,19 @@
     "!eventcatalog/node_modules/",
     "!eventcatalog/**/__tests__/",
     "!eventcatalog/**/*.{spec,test}.{js,jsx,cjs,mjs,ts,tsx,cts,mts}",
+    "!eventcatalog/.env*",
+    "!eventcatalog/.eventcatalog/",
+    "!eventcatalog/.eventcatalog-core/",
+    "!eventcatalog/eventcatalog.config.js",
+    "!eventcatalog/eventcatalog.styles.css",
+    "!eventcatalog/public/generated/",
+    "!eventcatalog/public/pagefind/",
+    "!eventcatalog/src/content/",
+    "!eventcatalog/src/catalog-files/",
+    "!eventcatalog/src/custom-defined-components/",
+    "!eventcatalog/src/custom-pages/",
+    "!eventcatalog/src/snippets/",
+    "!eventcatalog/src/generated-ai/",
     "bin/",
     "dist/"
   ],
@@ -121,8 +134,8 @@
     "uuid": "^11.1.1",
     "zod": "^4.3.6",
     "@eventcatalog/linter": "1.1.20",
-    "@eventcatalog/sdk": "2.29.1",
-    "@eventcatalog/visualiser": "^4.1.4"
+    "@eventcatalog/visualiser": "^4.1.4",
+    "@eventcatalog/sdk": "2.29.1"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",
@@ -155,7 +168,7 @@
   },
   "scripts": {
     "dev": "astro dev",
-    "build:bin": "tsup && node scripts/copy-docs-to-dist.mjs",
+    "build:bin": "tsup && node scripts/build-runtime-dependencies.mjs && node scripts/copy-docs-to-dist.mjs",
     "test": "cross-env DISABLE_EVENTCATALOG_CACHE=true vitest",
     "test:ci": "node scripts/ci/test.js",
     "start": "astro dev",