@eventcatalog/core 3.29.2 → 3.31.1

package/eventcatalog/src/layouts/VisualiserLayout.astro

@@ -53,8 +53,8 @@ const getColor = (collection: string) => {
 ---
 
 <VerticalSideBarLayout title={title} description={description}>
-  <div class="">
-    <div class="">
+  <div class="visualiser-full-bleed">
+    <div>
       <!-- <div class="hidden md:block">
         <aside class="sm:fixed grow w-56 xl:w-[19em] overflow-y-auto h-full z-10 pb-20" id="visualiser-navigation">
           <div class="w-full">
@@ -144,6 +144,11 @@ const getColor = (collection: string) => {
 </script>
 
 <style>
+  .visualiser-full-bleed {
+    margin-left: calc(var(--ec-app-content-padding-left, 5rem) * -1);
+    margin-right: calc(var(--ec-app-content-padding-right, 5rem) * -1);
+  }
+
   #visualiser-navigation {
     transform: translateX(0);
   }

package/eventcatalog/src/pages/_index.astro

@@ -1,14 +1,14 @@
 ---
 import { buildUrl } from '@utils/url-builder';
-import { ArrowRightIcon, PlusIcon } from '@heroicons/react/24/outline';
 import config from '@config';
 
 import { getCollection } from 'astro:content';
 import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
-import { BookOpenText, Workflow, TableProperties, BookUser, Code2, FileJson } from 'lucide-react';
+import { BookOpenText, Workflow, TableProperties, BookUser, Code2, FileJson, ArrowUpRight, ArrowRight, Plus } from 'lucide-react';
+
+const { showNestedSideBar = true } = Astro.props;
 
 // Lightweight data fetch: only raw collections, no hydration.
-// The homepage only needs counts + one item per type for default URLs.
 const [allDomains, allServices, allEvents, allCommands, allQueries, allFlows] = await Promise.all([
   getCollection('domains'),
   getCollection('services'),
@@ -23,11 +23,13 @@ const isCurrentVersion = (item: { data: { hidden?: boolean }; filePath?: string
 
 const domains = allDomains.filter(isCurrentVersion);
 const services = allServices.filter(isCurrentVersion);
-const messages = [...allEvents, ...allCommands, ...allQueries].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);
 
-// Check if catalog has content
-const hasContent = domains.length > 0 || services.length > 0 || messages.length > 0 || flows.length > 0;
+const totalResources = domains.length + services.length + messages.length + flows.length;
 
 const getDefaultUrl = (route: string, defaultValue: string) => {
   if (domains.length > 0) return buildUrl(`/${route}/domains/${domains[0].data.id}/${domains[0].data.version}`);
@@ -36,328 +38,323 @@ const getDefaultUrl = (route: string, defaultValue: string) => {
   return buildUrl(defaultValue);
 };
 
-const topTiles = [
+interface StatTile {
+  label: string;
+  count: number;
+  href: string;
+  emptyHref: string;
+  tone: string; // CSS color expression — drives accent rail + count gradient
+}
+
+const statTiles: StatTile[] = [
   {
-    title: 'Domains',
+    label: 'Domains',
     count: domains.length,
-    description: 'Business domains',
     href: buildUrl('/discover/domains'),
-    badgeBg: 'bg-[rgb(var(--ec-badge-domain-bg))]',
-    badgeText: 'text-[rgb(var(--ec-badge-domain-text))]',
-    glowColor: 'var(--ec-badge-domain-text)',
-    emptyText: 'No domains yet',
-    addHref: 'https://www.eventcatalog.dev/docs/domains',
+    emptyHref: 'https://www.eventcatalog.dev/docs/domains',
+    tone: '250 204 21', // amber-400
   },
   {
-    title: 'Services',
+    label: 'Services',
     count: services.length,
-    description: 'Documented services',
     href: buildUrl('/discover/services'),
-    badgeBg: 'bg-[rgb(var(--ec-badge-service-bg))]',
-    badgeText: 'text-[rgb(var(--ec-badge-service-text))]',
-    glowColor: 'var(--ec-badge-service-text)',
-    emptyText: 'No services yet',
-    addHref: 'https://www.eventcatalog.dev/docs/services',
+    emptyHref: 'https://www.eventcatalog.dev/docs/services',
+    tone: '244 114 182', // pink-400
   },
   {
-    title: 'Messages',
+    label: 'Messages',
     count: messages.length,
-    description: 'Events, commands & queries',
     href: buildUrl('/discover/events'),
-    badgeBg: 'bg-[rgb(var(--ec-badge-message-bg))]',
-    badgeText: 'text-[rgb(var(--ec-badge-message-text))]',
-    glowColor: 'var(--ec-badge-message-text)',
-    emptyText: 'No messages yet',
-    addHref: 'https://www.eventcatalog.dev/docs/messages',
+    emptyHref: 'https://www.eventcatalog.dev/docs/messages',
+    tone: '167 139 250', // violet-400
   },
   {
-    title: 'Flows',
+    label: 'Flows',
     count: flows.length,
-    description: 'Business flows',
     href: buildUrl('/discover/flows'),
-    badgeBg: 'bg-[rgb(var(--ec-badge-query-bg))]',
-    badgeText: 'text-[rgb(var(--ec-badge-query-text))]',
-    glowColor: 'var(--ec-badge-query-text)',
-    emptyText: 'No flows yet',
-    addHref: 'https://www.eventcatalog.dev/docs/flows',
+    emptyHref: 'https://www.eventcatalog.dev/docs/flows',
+    tone: '94 234 212', // teal-300
   },
 ];
 
-const quickActions = [
+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: 'Explore all your events, commands, queries, and services in one place.',
+    description: 'Browse every domain, service, message, and flow your teams have published.',
     icon: BookOpenText,
     href: getDefaultUrl('docs', 'domains'),
-    iconBg: 'bg-blue-50 dark:bg-blue-500/10',
-    iconColor: 'text-blue-600 dark:text-blue-400',
-    span: 'lg:col-span-2',
+    feature: true,
+    tone: '96 165 250', // blue-400
   },
   {
     title: 'Visualizer',
-    description: 'Visualize service relationships and message flows across your architecture.',
+    description: 'See how services connect — message flows across your architecture.',
     icon: Workflow,
     href: getDefaultUrl('visualiser', 'domains'),
-    iconBg: 'bg-[rgb(var(--ec-accent-subtle))]',
-    iconColor: 'text-[rgb(var(--ec-accent))]',
-    span: '',
+    tone: '167 139 250', // violet-400
   },
   {
     title: 'Discover',
-    description: 'Quickly find any event, service, or team across your entire catalog.',
+    description: 'Search every event, service, and team across the catalog.',
     icon: TableProperties,
     href: buildUrl('/discover/events'),
-    iconBg: 'bg-teal-50 dark:bg-teal-500/10',
-    iconColor: 'text-teal-600 dark:text-teal-400',
-    span: '',
+    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'),
-    iconBg: 'bg-amber-50 dark:bg-amber-500/10',
-    iconColor: 'text-amber-600 dark:text-amber-400',
-    span: '',
+    tone: '250 204 21', // amber-400
   },
   {
     title: 'Team Directory',
-    description: 'See who owns what — find team contacts and service ownership at a glance.',
+    description: 'Find owners, on-call contacts, and the team behind every service.',
     icon: BookUser,
     href: buildUrl('/directory/users'),
-    iconBg: 'bg-orange-50 dark:bg-orange-500/10',
-    iconColor: 'text-orange-600 dark:text-orange-400',
-    span: '',
+    tone: '251 146 60', // orange-400
   },
   {
     title: 'API & SDK',
-    description: 'Query and manage your catalog programmatically with a fully-typed SDK.',
+    description: 'Programmatic access — query and manage your catalog with a typed SDK.',
     icon: Code2,
     href: 'https://www.eventcatalog.dev/docs/sdk',
-    iconBg: 'bg-indigo-50 dark:bg-indigo-500/10',
-    iconColor: 'text-indigo-600 dark:text-indigo-400',
     external: true,
-    span: 'lg:col-span-2',
+    tone: '129 140 248', // indigo-400
   },
 ];
 ---
 
-<VerticalSideBarLayout title="EventCatalog">
-  <div class="min-h-screen font-inter">
-    <!-- Hero Section -->
-    <div class="relative">
-      <main class="px-6 lg:px-8 pt-10 pb-8 max-w-[85em]">
-        <div class="flex flex-col md:flex-row md:items-center md:justify-between gap-4">
-          <div>
-            <h1 class="text-2xl md:text-3xl font-bold mb-1 text-[rgb(var(--ec-page-text))] tracking-tight">
-              Welcome to <span class="italic text-[rgb(var(--ec-accent))]">{config?.organizationName || 'EventCatalog'}</span>
-            </h1>
-            <p class="text-sm text-[rgb(var(--ec-page-text-muted))] leading-relaxed">
-              {config.tagline || 'Explore and understand your event-driven architecture'}
-            </p>
-          </div>
+<VerticalSideBarLayout title="EventCatalog" 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>
-      </main>
-    </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>
 
-    <!-- Main Content -->
-    <main class="px-6 lg:px-8 pb-8 max-w-[85em]">
-      <!-- Stat Cards -->
-      <section class="mb-10">
-        <div class="grid grid-cols-2 md:grid-cols-4 gap-4">
-          {
-            topTiles.map((tile: any) =>
-              tile.count > 0 ? (
-                <a
-                  href={tile.href}
-                  class="ec-stat-card group relative overflow-hidden bg-[rgb(var(--ec-card-bg,var(--ec-page-bg)))] p-5 rounded-xl border transition-all"
-                  style={`--glow-color: rgb(${tile.glowColor}); border-color: rgb(${tile.glowColor} / 0.2);`}
-                >
-                  <div class="flex items-center justify-between mb-4">
-                    <span
-                      class={`inline-flex items-center px-2.5 py-0.5 rounded-md text-xs font-semibold ${tile.badgeBg} ${tile.badgeText}`}
-                    >
-                      {tile.title}
-                    </span>
-                  </div>
-                  <div class="text-3xl font-bold text-[rgb(var(--ec-page-text))] mb-1">{tile.count}</div>
-                  <div class="text-sm text-[rgb(var(--ec-page-text-muted))]">{tile.description}</div>
-                </a>
+    <!-- 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))]" />
               ) : (
-                <div class="relative overflow-hidden bg-[rgb(var(--ec-content-hover))] p-5 rounded-xl border border-dashed border-[rgb(var(--ec-page-border))]">
-                  <div class="flex items-center justify-between mb-4">
-                    <span class="inline-flex items-center px-2.5 py-0.5 rounded-md text-xs font-semibold bg-[rgb(var(--ec-badge-default-bg))] text-[rgb(var(--ec-badge-default-text))]">
-                      {tile.title}
-                    </span>
-                  </div>
-                  <div class="text-sm font-medium text-[rgb(var(--ec-page-text-muted))] mb-2">{tile.emptyText}</div>
-                  <a
-                    href={tile.addHref}
-                    target="_blank"
-                    class="inline-flex items-center gap-1 text-xs font-medium text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))]"
-                  >
-                    <PlusIcon className="w-3 h-3" />
-                    Add {tile.title.toLowerCase()}
-                  </a>
-                </div>
-              )
-            )
-          }
-        </div>
-      </section>
+                <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>
 
-      <!-- Explore Section - Full Width -->
-      <section class="mb-10">
-        <div class="flex items-center gap-4 mb-4">
-          <h2 class="text-sm font-semibold uppercase tracking-wider text-[rgb(var(--ec-page-text-muted))] flex-shrink-0">
-            Explore
-          </h2>
-          <div class="flex-1 h-px bg-[rgb(var(--ec-page-border))]"></div>
-        </div>
-        <div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4">
-          {
-            quickActions.map((action: any) => (
-              <a
-                href={action.href}
-                target={action.external ? '_blank' : undefined}
-                class={`ec-stat-card group flex flex-col bg-[rgb(var(--ec-card-bg,var(--ec-page-bg)))] p-6 rounded-xl border border-[rgb(var(--ec-page-border))] hover:border-[rgb(var(--ec-accent)/0.5)] transition-all min-h-[160px] ${action.span}`}
-                style="--glow-color: rgb(var(--ec-accent));"
-              >
-                <div class="flex items-center gap-3 mb-3">
-                  <div class={`${action.iconBg} p-2.5 rounded-lg`}>
-                    <action.icon className={`w-5 h-5 ${action.iconColor}`} />
-                  </div>
-                  <span class="font-semibold text-[rgb(var(--ec-page-text))] flex items-center gap-1.5">
-                    {action.title}
-                    {action.external && (
-                      <svg
-                        class="w-3.5 h-3.5 text-[rgb(var(--ec-icon-color))]"
-                        fill="none"
-                        stroke="currentColor"
-                        viewBox="0 0 24 24"
-                      >
-                        <path
-                          stroke-linecap="round"
-                          stroke-linejoin="round"
-                          stroke-width="2"
-                          d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14"
-                        />
-                      </svg>
-                    )}
-                  </span>
-                </div>
-                <p class="text-sm text-[rgb(var(--ec-page-text-muted))] leading-relaxed">{action.description}</p>
-              </a>
-            ))
-          }
-        </div>
-      </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>
 
-      <!-- Resources & Community - Compact Footer Style -->
-      <section class="border-t border-[rgb(var(--ec-page-border))] pt-8 pb-4">
-        <div class="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-6">
-          <div class="flex flex-wrap items-center gap-x-6 gap-y-3">
-            <a
-              href="https://www.eventcatalog.dev/docs/development/getting-started/introduction"
-              target="_blank"
-              class="text-sm text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] transition-colors"
-            >
-              Getting Started
-            </a>
-            <a
-              href="https://www.eventcatalog.dev/integrations"
-              target="_blank"
-              class="text-sm text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] transition-colors"
-            >
-              Integrations
-            </a>
-            <a
-              href="https://www.eventcatalog.dev/docs"
-              target="_blank"
-              class="text-sm text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] transition-colors"
-            >
-              Documentation
-            </a>
-          </div>
-          <div class="flex items-center gap-4">
-            <a
-              href="https://discord.gg/3rjaZMmrAm"
-              target="_blank"
-              class="flex items-center gap-2 text-sm text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] transition-colors"
-              title="Join Discord"
-            >
-              <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
-                <path
-                  d="M20.317 4.37a19.791 19.791 0 0 0-4.885-1.515a.074.074 0 0 0-.079.037c-.21.375-.444.864-.608 1.25a18.27 18.27 0 0 0-5.487 0a12.64 12.64 0 0 0-.617-1.25a.077.077 0 0 0-.079-.037A19.736 19.736 0 0 0 3.677 4.37a.07.07 0 0 0-.032.027C.533 9.046-.32 13.58.099 18.057a.082.082 0 0 0 .031.057a19.9 19.9 0 0 0 5.993 3.03a.078.078 0 0 0 .084-.028a14.09 14.09 0 0 0 1.226-1.994a.076.076 0 0 0-.041-.106a13.107 13.107 0 0 1-1.872-.892a.077.077 0 0 1-.008-.128a10.2 10.2 0 0 0 .372-.292a.074.074 0 0 1 .077-.01c3.928 1.793 8.18 1.793 12.062 0a.074.074 0 0 1 .078.01c.12.098.246.198.373.292a.077.077 0 0 1-.006.127a12.299 12.299 0 0 1-1.873.892a.077.077 0 0 0-.041.107c.36.698.772 1.362 1.225 1.993a.076.076 0 0 0 .084.028a19.839 19.839 0 0 0 6.002-3.03a.077.077 0 0 0 .032-.054c.5-5.177-.838-9.674-3.549-13.66a.061.061 0 0 0-.031-.03zM8.02 15.33c-1.183 0-2.157-1.085-2.157-2.419c0-1.333.956-2.419 2.157-2.419c1.21 0 2.176 1.096 2.157 2.42c0 1.333-.956 2.418-2.157 2.418zm7.975 0c-1.183 0-2.157-1.085-2.157-2.419c0-1.333.955-2.419 2.157-2.419c1.21 0 2.176 1.096 2.157 2.42c0 1.333-.946 2.418-2.157 2.418z"
-                ></path>
-              </svg>
-              <span class="hidden sm:inline">Discord</span>
-            </a>
+      <div class="ec-explore-grid mt-4">
+        {
+          exploreCards.map((card) => (
             <a
-              href="https://github.com/event-catalog/eventcatalog"
-              target="_blank"
-              class="flex items-center gap-2 text-sm text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] transition-colors"
-              title="GitHub"
+              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};`}
             >
-              <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
-                <path
-                  fill-rule="evenodd"
-                  d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z"
-                  clip-rule="evenodd"></path>
-              </svg>
-              <span class="hidden sm:inline">GitHub</span>
+              <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>
-        </div>
-      </section>
-    </main>
+          ))
+        }
+      </div>
+    </section>
   </div>
 </VerticalSideBarLayout>
 
 <style is:global>
-  .ec-stat-card {
+  .ec-home {
+    /* Negate the layout wrapper's horizontal padding so the homepage controls its own. */
+    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-card::before {
-    content: '';
-    position: absolute;
-    inset: 0;
-    border-radius: inherit;
-    transition: opacity 0.3s ease;
-    opacity: 0;
-    pointer-events: none;
-    z-index: 0;
+  .ec-stat:hover {
+    border-color: rgb(var(--ec-accent) / 0.5);
+    transform: translateY(-1px);
   }
-  /* Dark mode: radial glow that follows cursor */
-  :root[data-theme='dark'] .ec-stat-card::before {
-    background: radial-gradient(400px circle at var(--mouse-x, 50%) var(--mouse-y, 50%), var(--glow-color) 0%, transparent 70%);
+
+  .ec-section-eyebrow {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
   }
-  :root[data-theme='dark'] .ec-stat-card:hover::before {
-    opacity: 0.15;
+  .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;
   }
-  /* Light mode: subtle solid background */
-  :root:not([data-theme='dark']) .ec-stat-card::before,
-  :root[data-theme='light'] .ec-stat-card::before {
-    background: rgb(var(--ec-content-hover));
+  @media (min-width: 640px) {
+    .ec-explore-grid {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
   }
-  :root:not([data-theme='dark']) .ec-stat-card:hover::before,
-  :root[data-theme='light'] .ec-stat-card:hover::before {
-    opacity: 1;
+  @media (min-width: 1024px) {
+    .ec-explore-grid {
+      grid-template-columns: repeat(3, minmax(0, 1fr));
+    }
   }
-  .ec-stat-card > * {
+
+  .ec-card {
     position: relative;
-    z-index: 1;
+    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);
   }
-</style>
 
-<script>
-  document.querySelectorAll('.ec-stat-card').forEach((card) => {
-    card.addEventListener('mousemove', (e) => {
-      const rect = (e.currentTarget as HTMLElement).getBoundingClientRect();
-      const x = (e as MouseEvent).clientX - rect.left;
-      const y = (e as MouseEvent).clientY - rect.top;
-      (e.currentTarget as HTMLElement).style.setProperty('--mouse-x', `${x}px`);
-      (e.currentTarget as HTMLElement).style.setProperty('--mouse-y', `${y}px`);
-    });
-  });
-</script>
+  .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>