@eventcatalog/core 5.0.0-beta.29 → 5.0.0-beta.30

package/eventcatalog/src/features/studio/components/LeftPanel.tsx

@@ -126,6 +126,9 @@ function CatalogList({
       <div className="relative">
         <Search size={14} className="absolute left-2.5 top-1/2 -translate-y-1/2 text-[rgb(var(--ec-icon-color))]" />
         <input
+          // The list shows when its tab is chosen: typing then searches it, rather than reaching the canvas's shortcuts
+          // (from the tab button, typing "Order Service" picked the Comment tool)
+          autoFocus
           value={search}
           onChange={(e) => setSearch(e.target.value)}
           placeholder="Search the catalog"

package/eventcatalog/src/pages/_index.astro

@@ -1,358 +1,21 @@
 ---
-import { buildUrl } from '@utils/url-builder';
-import config from '@config';
-
-import { getCollection } from 'astro:content';
 import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
-import { BookOpenText, Workflow, TableProperties, BookUser, Code2, FileJson, ArrowUpRight, ArrowRight, Plus } from 'lucide-react';
+import CatalogDashboard from '@components/Homepage/CatalogDashboard.astro';
 
 const { showNestedSideBar = true } = Astro.props;
-
-// Lightweight data fetch: only raw collections, no hydration.
-const [allDomains, allServices, allEvents, allCommands, allQueries, allFlows] = await Promise.all([
-  getCollection('domains'),
-  getCollection('services'),
-  getCollection('events'),
-  getCollection('commands'),
-  getCollection('queries'),
-  getCollection('flows'),
-]);
-
-const isCurrentVersion = (item: { data: { hidden?: boolean }; filePath?: string }) =>
-  item.data.hidden !== true && !item.filePath?.includes('versioned');
-
-const domains = allDomains.filter(isCurrentVersion);
-const services = allServices.filter(isCurrentVersion);
-const events = allEvents.filter(isCurrentVersion);
-const commands = allCommands.filter(isCurrentVersion);
-const queries = allQueries.filter(isCurrentVersion);
-const messages = [...events, ...commands, ...queries];
-const flows = allFlows.filter(isCurrentVersion);
-
-const getDefaultUrl = (route: string, defaultValue: string) => {
-  if (domains.length > 0) return buildUrl(`/${route}/domains/${domains[0].data.id}/${domains[0].data.version}`);
-  if (services.length > 0) return buildUrl(`/${route}/services/${services[0].data.id}/${services[0].data.version}`);
-  if (flows.length > 0) return buildUrl(`/${route}/flows/${flows[0].data.id}/${flows[0].data.version}`);
-  return buildUrl(defaultValue);
-};
-
-interface StatTile {
-  label: string;
-  count: number;
-  href: string;
-  emptyHref: string;
-  tone: string; // CSS color expression — drives accent rail + count gradient
-}
-
-const statTiles: StatTile[] = [
-  {
-    label: 'Domains',
-    count: domains.length,
-    href: buildUrl('/discover/domains'),
-    emptyHref: 'https://www.eventcatalog.dev/docs/domains',
-    tone: '250 204 21', // amber-400
-  },
-  {
-    label: 'Services',
-    count: services.length,
-    href: buildUrl('/discover/services'),
-    emptyHref: 'https://www.eventcatalog.dev/docs/services',
-    tone: '244 114 182', // pink-400
-  },
-  {
-    label: 'Messages',
-    count: messages.length,
-    href: buildUrl('/discover/events'),
-    emptyHref: 'https://www.eventcatalog.dev/docs/messages',
-    tone: '167 139 250', // violet-400
-  },
-  {
-    label: 'Flows',
-    count: flows.length,
-    href: buildUrl('/discover/flows'),
-    emptyHref: 'https://www.eventcatalog.dev/docs/flows',
-    tone: '94 234 212', // teal-300
-  },
-];
-
-interface ExploreCard {
-  title: string;
-  description: string;
-  icon: any;
-  href: string;
-  external?: boolean;
-  /** When true, renders as the lead "feature" card with extra width and CTA styling. */
-  feature?: boolean;
-  tone: string; // RGB triple for the icon tile
-}
-
-const exploreCards: ExploreCard[] = [
-  {
-    title: 'Documentation',
-    description: 'Browse every domain, service, message, and flow your teams have published.',
-    icon: BookOpenText,
-    href: getDefaultUrl('docs', 'domains'),
-    feature: true,
-    tone: '96 165 250', // blue-400
-  },
-  {
-    title: 'Visualizer',
-    description: 'See how services connect — message flows across your architecture.',
-    icon: Workflow,
-    href: getDefaultUrl('visualiser', 'domains'),
-    tone: '167 139 250', // violet-400
-  },
-  {
-    title: 'Discover',
-    description: 'Search every event, service, agent, and team across the catalog.',
-    icon: TableProperties,
-    href: buildUrl('/discover/events'),
-    tone: '94 234 212', // teal-300
-  },
-  {
-    title: 'Schema Explorer',
-    description: 'Track schema evolution, compare versions, and catch breaking changes.',
-    icon: FileJson,
-    href: buildUrl('/schemas/explorer'),
-    tone: '250 204 21', // amber-400
-  },
-  {
-    title: 'Team Directory',
-    description: 'Find owners, on-call contacts, and the team behind every service.',
-    icon: BookUser,
-    href: buildUrl('/directory/users'),
-    tone: '251 146 60', // orange-400
-  },
-  {
-    title: 'API & SDK',
-    description: 'Programmatic access — query and manage your catalog with a typed SDK.',
-    icon: Code2,
-    href: 'https://www.eventcatalog.dev/docs/sdk',
-    external: true,
-    tone: '129 140 248', // indigo-400
-  },
-];
 ---
 
 <VerticalSideBarLayout showNestedSideBar={showNestedSideBar}>
-  <div class="ec-home min-h-screen">
-    <!-- Hero -->
-    <header class="ec-hero">
-      <div class="text-[11px] font-semibold uppercase tracking-[0.18em] text-[rgb(var(--ec-accent))]">Catalog</div>
-      <div class="mt-3 flex flex-col gap-3 md:flex-row md:items-end md:justify-between">
-        <div>
-          <h1 class="text-[28px] font-semibold leading-[1.1] tracking-tight text-[rgb(var(--ec-page-text))] md:text-[32px]">
-            {config?.organizationName || 'EventCatalog'}
-          </h1>
-          <p class="mt-2 max-w-2xl text-[14px] leading-relaxed text-[rgb(var(--ec-page-text-muted))]">
-            {config.tagline || 'Explore and understand your event-driven architecture.'}
-          </p>
-        </div>
-        <div class="flex items-center gap-2">
-          <a
-            href={getDefaultUrl('docs', 'domains')}
-            class="ec-btn-primary inline-flex items-center gap-1.5 rounded-md bg-[rgb(var(--ec-page-bg))] border border-[rgb(var(--ec-page-border))] px-3.5 py-2 text-[12.5px] font-semibold text-[rgb(var(--ec-page-text-muted))] transition-colors hover:border-[rgb(var(--ec-accent)/0.5)] hover:text-[rgb(var(--ec-accent))]"
-          >
-            Explore Catalog
-            <ArrowRight className="h-3.5 w-3.5" />
-          </a>
-        </div>
-      </div>
-    </header>
-
-    <div class="ec-divider"></div>
-
-    <!-- Stat strip -->
-    <section class="ec-stats">
-      {
-        statTiles.map((tile) => (
-          <a
-            href={tile.count > 0 ? tile.href : tile.emptyHref}
-            target={tile.count === 0 ? '_blank' : undefined}
-            rel={tile.count === 0 ? 'noreferrer' : undefined}
-            class="ec-stat group"
-            style={`--tone: ${tile.tone};`}
-          >
-            <div class="flex items-baseline justify-between gap-2">
-              <span class="text-[11px] font-medium uppercase tracking-[0.14em] text-[rgb(var(--tone))]">{tile.label}</span>
-              {tile.count > 0 ? (
-                <ArrowUpRight className="h-3.5 w-3.5 text-[rgb(var(--ec-page-text-muted))] transition-transform duration-200 group-hover:-translate-y-0.5 group-hover:translate-x-0.5 group-hover:text-[rgb(var(--ec-accent))]" />
-              ) : (
-                <Plus className="h-3.5 w-3.5 text-[rgb(var(--ec-page-text-muted))] transition-colors group-hover:text-[rgb(var(--ec-accent))]" />
-              )}
-            </div>
-            <div class="mt-3 flex items-baseline gap-2">
-              <span class="font-mono text-[34px] font-semibold leading-none tracking-tight text-[rgb(var(--ec-page-text))]">
-                {tile.count}
-              </span>
-              {tile.count === 0 && <span class="text-[12px] text-[rgb(var(--ec-page-text-muted))]">— add some</span>}
-            </div>
-          </a>
-        ))
-      }
-    </section>
-
-    <!-- Eyebrow + Explore grid -->
-    <section class="mt-12">
-      <div class="ec-section-eyebrow">
-        <span class="text-[11px] font-semibold uppercase tracking-[0.18em] text-[rgb(var(--ec-accent))]">Explore</span>
-        <span class="ec-section-rule"></span>
-        <span class="font-mono text-[11px] text-[rgb(var(--ec-page-text-muted)/0.7)]">{exploreCards.length} sections</span>
-      </div>
-
-      <div class="ec-explore-grid mt-4">
-        {
-          exploreCards.map((card) => (
-            <a
-              href={card.href}
-              target={card.external ? '_blank' : undefined}
-              rel={card.external ? 'noreferrer' : undefined}
-              class:list={['ec-card group', card.feature ? 'ec-card--feature' : '']}
-              style={`--tone: ${card.tone};`}
-            >
-              <div class="flex items-start justify-between gap-3">
-                <div class="ec-card-icon">
-                  <card.icon className="h-4 w-4" />
-                </div>
-                <ArrowUpRight className="h-3.5 w-3.5 text-[rgb(var(--ec-page-text-muted))] transition-transform duration-200 group-hover:-translate-y-0.5 group-hover:translate-x-0.5 group-hover:text-[rgb(var(--ec-accent))]" />
-              </div>
-              <h3 class="mt-4 text-[15px] font-semibold tracking-tight text-[rgb(var(--ec-page-text))]">{card.title}</h3>
-              <p class="mt-1.5 text-[13px] leading-relaxed text-[rgb(var(--ec-page-text-muted))]">{card.description}</p>
-            </a>
-          ))
-        }
-      </div>
-    </section>
+  <div class="ec-home">
+    <CatalogDashboard />
   </div>
 </VerticalSideBarLayout>
 
 <style is:global>
   .ec-home {
-    /* Negate the layout wrapper's horizontal padding so the homepage controls its own. */
+    /* The layout pads its content: the homepage sets its own, wider spacing */
     margin-left: calc(var(--ec-app-content-padding-left, 5rem) * -1);
     margin-right: calc(var(--ec-app-content-padding-right, 5rem) * -1);
     padding: 2rem 2rem 0;
   }
-  .ec-hero {
-    padding-bottom: 1.5rem;
-  }
-  .ec-divider {
-    height: 1px;
-    background: linear-gradient(
-      to right,
-      transparent,
-      rgb(var(--ec-page-border)) 12%,
-      rgb(var(--ec-page-border)) 88%,
-      transparent
-    );
-    margin: 0.25rem 0 1.5rem;
-  }
-  .ec-stats {
-    display: grid;
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-    gap: 0.75rem;
-  }
-  @media (min-width: 768px) {
-    .ec-stats {
-      grid-template-columns: repeat(4, minmax(0, 1fr));
-    }
-  }
-  .ec-stat {
-    position: relative;
-    display: flex;
-    flex-direction: column;
-    overflow: hidden;
-    border: 1px solid rgb(var(--ec-page-border));
-    border-radius: 0.75rem;
-    background:
-      radial-gradient(80% 100% at 0% 0%, rgb(var(--tone) / 0.05), transparent 60%), rgb(var(--ec-card-bg, var(--ec-page-bg)));
-    padding: 1rem 1.1rem 1.1rem;
-    transition:
-      border-color 200ms,
-      transform 200ms,
-      box-shadow 200ms;
-    text-decoration: none;
-  }
-  .ec-stat:hover {
-    border-color: rgb(var(--ec-accent) / 0.5);
-    transform: translateY(-1px);
-  }
-
-  .ec-section-eyebrow {
-    display: flex;
-    align-items: center;
-    gap: 0.75rem;
-  }
-  .ec-section-rule {
-    flex: 1;
-    height: 1px;
-    background: linear-gradient(to right, rgb(var(--ec-accent) / 0.4), rgb(var(--ec-page-border)) 30%);
-  }
-
-  /* Explore grid: bordered cells with breathing room between them. */
-  .ec-explore-grid {
-    display: grid;
-    grid-template-columns: repeat(1, minmax(0, 1fr));
-    gap: 1rem;
-  }
-  @media (min-width: 640px) {
-    .ec-explore-grid {
-      grid-template-columns: repeat(2, minmax(0, 1fr));
-    }
-  }
-  @media (min-width: 1024px) {
-    .ec-explore-grid {
-      grid-template-columns: repeat(3, minmax(0, 1fr));
-    }
-  }
-
-  .ec-card {
-    position: relative;
-    display: flex;
-    flex-direction: column;
-    padding: 1.5rem 1.5rem 1.4rem;
-    text-decoration: none;
-    border: 1px solid rgb(var(--ec-page-border));
-    border-radius: 0.875rem;
-    background: rgb(var(--ec-card-bg, var(--ec-page-bg)));
-    transition:
-      background 200ms,
-      border-color 200ms;
-    min-height: 9.5rem;
-  }
-  .ec-card:hover {
-    background: rgb(var(--ec-page-bg) / 0.4);
-    border-color: rgb(var(--ec-accent) / 0.5);
-  }
-
-  .ec-card--feature {
-    background:
-      radial-gradient(60% 90% at 0% 0%, rgb(var(--tone) / 0.07), transparent 60%), rgb(var(--ec-card-bg, var(--ec-page-bg)));
-  }
-  .ec-card--feature:hover {
-    background: radial-gradient(60% 90% at 0% 0%, rgb(var(--ec-accent) / 0.12), transparent 60%), rgb(var(--ec-page-bg) / 0.4);
-  }
-
-  .ec-card-icon {
-    display: inline-flex;
-    height: 2.25rem;
-    width: 2.25rem;
-    align-items: center;
-    justify-content: center;
-    border-radius: 0.5rem;
-    background: rgb(var(--tone) / 0.12);
-    color: rgb(var(--tone));
-    transition:
-      background 200ms,
-      color 200ms;
-  }
-  .ec-card:hover .ec-card-icon {
-    background: rgb(var(--ec-accent) / 0.2);
-    color: rgb(var(--ec-accent));
-  }
-  .ec-card--feature .ec-card-icon {
-    height: 2.5rem;
-    width: 2.5rem;
-    border-radius: 0.625rem;
-  }
 </style>

package/eventcatalog/src/pages/index.astro

@@ -30,7 +30,9 @@ if (existsSync(pathToUserDefinedLandingPage)) {
     import('@components/MDX/page-components'),
     import('@components/MDX/components'),
   ]);
-  customHomepageComponents = { ...pageComponents, ...mdxComponents(props) };
+  const { default: CatalogDashboard } = await import('@components/Homepage/CatalogDashboard.astro');
+  // A custom homepage can show the catalog dashboard too: <CatalogDashboard /> from Astro.props.components
+  customHomepageComponents = { ...pageComponents, ...mdxComponents(props), CatalogDashboard };
 
   const rawContent = readFileSync(pathToUserDefinedLandingPage, 'utf-8');
   nodeGraphs = getMDXComponentsByName(rawContent, 'NodeGraph') || [];

package/eventcatalog/src/utils/git.ts

@@ -87,6 +87,17 @@ const readCommit = (filePath: string, age: 'newest' | 'oldest'): Commit => {
   return parseCommit(match.groups.header);
 };
 
+/**
+ * When a file was last committed, from the history read once for the whole repository: never runs git for one file,
+ * so it's cheap to ask for many (e.g. every resource on the homepage). Undefined without git, or for a file that isn't
+ * committed.
+ */
+export function getLastCommitDate(filePath: string): Date | undefined {
+  if (!hasGit()) return undefined;
+  const commit = getNewestCommits()?.get(toRealPath(filePath));
+  return commit ? new Date(commit.timestamp) : undefined;
+}
+
 export function getGitHistory(
   filePath: string,
   {

package/eventcatalog/src/utils/homepage-dashboard.ts

@@ -0,0 +1,143 @@
+import path from 'node:path';
+import { statSync } from 'node:fs';
+import { getCollection } from 'astro:content';
+import { getLastCommitDate } from '@utils/git';
+import { buildUrl } from '@utils/url-builder';
+
+/** The resources the dashboard shows, by collection */
+export type DashboardCollection = 'domains' | 'services' | 'events' | 'commands' | 'queries' | 'flows';
+
+type Owner = { id: string };
+
+/** The fields the dashboard reads from a collection entry */
+export type DashboardEntry = {
+  filePath?: string;
+  data: {
+    id: string;
+    name?: string;
+    version: string;
+    summary?: string;
+    hidden?: boolean;
+    owners?: Owner[];
+    schemaPath?: string;
+  };
+};
+
+export type DashboardResource = {
+  collection: DashboardCollection;
+  id: string;
+  version: string;
+  name: string;
+  summary?: string;
+  href: string;
+  owners: { id: string; name: string }[];
+  updatedAt?: number;
+};
+
+export type DashboardData = {
+  counts: Record<DashboardCollection | 'messages' | 'schemas' | 'teams' | 'users', number>;
+  recentlyUpdated: DashboardResource[];
+};
+
+const MESSAGE_COLLECTIONS = ['events', 'commands', 'queries'] as const;
+
+// The latest version of a resource that isn't hidden (older versions live in a `versioned` folder)
+const isCurrent = (entry: DashboardEntry) => entry.data.hidden !== true && !entry.filePath?.includes('versioned');
+
+/**
+ * Everything the homepage dashboard shows, from the catalog's collections: counts, and what changed recently.
+ */
+export const buildDashboard = ({
+  collections,
+  teams,
+  users,
+  getUpdatedAt,
+}: {
+  collections: Record<DashboardCollection, DashboardEntry[]>;
+  teams: DashboardEntry[];
+  users: DashboardEntry[];
+  /** When a resource's file last changed (unix ms), if known */
+  getUpdatedAt: (entry: DashboardEntry) => number | undefined;
+}): DashboardData => {
+  const ownerNames = new Map<string, string>();
+  for (const owner of [...teams, ...users]) ownerNames.set(owner.data.id, owner.data.name ?? owner.data.id);
+
+  const toResource = (collection: DashboardCollection, entry: DashboardEntry): DashboardResource => ({
+    collection,
+    id: entry.data.id,
+    version: entry.data.version,
+    name: entry.data.name ?? entry.data.id,
+    summary: entry.data.summary?.trim() || undefined,
+    href: buildUrl(`/docs/${collection}/${entry.data.id}/${entry.data.version}`),
+    owners: (entry.data.owners ?? []).map(({ id }) => ({ id, name: ownerNames.get(id) ?? id })),
+    updatedAt: getUpdatedAt(entry),
+  });
+
+  const current = Object.fromEntries(
+    Object.entries(collections).map(([collection, entries]) => [collection, entries.filter(isCurrent)])
+  ) as Record<DashboardCollection, DashboardEntry[]>;
+  const messages = MESSAGE_COLLECTIONS.flatMap((collection) => current[collection]);
+  const all = (Object.keys(current) as DashboardCollection[]).flatMap((collection) =>
+    current[collection].map((entry) => ({ entry, resource: toResource(collection, entry) }))
+  );
+
+  const recentlyUpdated = all
+    .map(({ resource }) => resource)
+    .filter((resource) => resource.updatedAt !== undefined)
+    .sort((a, b) => b.updatedAt! - a.updatedAt!)
+    .slice(0, 8);
+
+  const withSchema = messages.filter((entry) => entry.data.schemaPath).length;
+
+  return {
+    counts: {
+      domains: current.domains.length,
+      services: current.services.length,
+      events: current.events.length,
+      commands: current.commands.length,
+      queries: current.queries.length,
+      flows: current.flows.length,
+      messages: messages.length,
+      schemas: withSchema,
+      teams: teams.filter(isCurrent).length,
+      users: users.filter(isCurrent).length,
+    },
+    recentlyUpdated,
+  };
+};
+
+// When a resource's file last changed: its last commit, or (without git, or before it's committed) the file's date
+const getUpdatedAt = (entry: DashboardEntry) => {
+  if (!entry.filePath) return undefined;
+  const file = path.resolve(process.env.PROJECT_DIR || process.cwd(), entry.filePath);
+  const committed = getLastCommitDate(file);
+  if (committed) return committed.getTime();
+  try {
+    return statSync(file).mtimeMs;
+  } catch {
+    return undefined;
+  }
+};
+
+/** The homepage dashboard for this catalog */
+export const getDashboard = async (): Promise<DashboardData> => {
+  const [domains, services, events, commands, queries, flows, teams, users] = await Promise.all([
+    getCollection('domains'),
+    getCollection('services'),
+    getCollection('events'),
+    getCollection('commands'),
+    getCollection('queries'),
+    getCollection('flows'),
+    getCollection('teams'),
+    getCollection('users'),
+  ]);
+  return buildDashboard({
+    collections: { domains, services, events, commands, queries, flows } as unknown as Record<
+      DashboardCollection,
+      DashboardEntry[]
+    >,
+    teams: teams as unknown as DashboardEntry[],
+    users: users as unknown as DashboardEntry[],
+    getUpdatedAt,
+  });
+};

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "BUSL-1.1",
   "type": "module",
-  "version": "5.0.0-beta.29",
+  "version": "5.0.0-beta.30",
   "publishConfig": {
     "access": "public"
   },
@@ -142,8 +142,8 @@
     "yjs": "^13.6.33",
     "zod": "^4.3.6",
     "@eventcatalog/linter": "1.2.0-beta.4",
-    "@eventcatalog/visualiser": "^5.0.0-beta.6",
-    "@eventcatalog/sdk": "2.30.0-beta.1"
+    "@eventcatalog/sdk": "2.30.0-beta.1",
+    "@eventcatalog/visualiser": "^5.0.0-beta.7"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",