From 9514ca3a65507fd9814077d296767ce66b46a069 Mon Sep 17 00:00:00 2001
From: Greg Holmes <iam@gregholmes.co.uk>
Date: Mon, 7 Jul 2025 09:32:30 +0100
Subject: [PATCH] Add getting-started index page

---
 src/components/Layout/MDXWrapper.tsx |  2 ++
 src/components/Layout/mdx/tiles.tsx  | 43 ++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 src/components/Layout/mdx/tiles.tsx

diff --git a/src/components/Layout/MDXWrapper.tsx b/src/components/Layout/MDXWrapper.tsx
index ef5c5c342e..9059726da7 100644
--- a/src/components/Layout/MDXWrapper.tsx
+++ b/src/components/Layout/MDXWrapper.tsx
@@ -16,6 +16,7 @@ import { HtmlComponentPropsData } from '../html-component-props';
 import { languageData } from 'src/data/languages';
 import { ActivePage } from './utils/nav';
 import { Table, TableHead, TableBody, TableRow, TableHeader, TableCell } from './mdx/tables';
+import { Tiles } from './mdx/tiles';
 import { Head } from '../Head';
 import { useSiteMetadata } from 'src/hooks/use-site-metadata';
 import { ProductName } from 'src/templates/template-data';
@@ -126,6 +127,7 @@ const MDXWrapper: React.FC<MDXWrapperProps> = ({ children, pageContext, location
             tr: TableRow,
             th: TableHeader,
             td: TableCell,
+            Tiles,
           }}
         >
           <PageTitle>{title}</PageTitle>
diff --git a/src/components/Layout/mdx/tiles.tsx b/src/components/Layout/mdx/tiles.tsx
new file mode 100644
index 0000000000..a4d50b48b4
--- /dev/null
+++ b/src/components/Layout/mdx/tiles.tsx
@@ -0,0 +1,43 @@
+import Link from 'src/components/Link';
+import Icon from '@ably/ui/core/Icon';
+import { IconName } from '@ably/ui/core/Icon/types';
+
+type TileProps = {
+  title?: string;
+  description?: string;
+  image?: IconName;
+  link?: string;
+};
+
+const Tile = ({ title, description, image, link = '/docs' }: TileProps) => {
+  return (
+    <Link to={link} className="block no-underline">
+      <section
+        className="flex items-start gap-4 p-4 bg-neutral-100 dark:bg-neutral-1200 rounded-lg border border-neutral-300 dark:border-neutral-1000
+        transition-colors hover:bg-neutral-200 dark:hover:bg-neutral-1100 hover:border-neutral-400 dark:hover:border-neutral-900 min-h-[112px]"
+      >
+        <div className="w-12 h-12 bg-neutral-000 dark:bg-neutral-1300 rounded-xl p-2.5 flex items-center justify-center flex-shrink-0">
+          {image && <Icon name={image} size="2rem" />}
+        </div>
+        <div className="flex-1 max-w-66">
+          <h3 className="text-lg font-bold leading-tight tracking-tight mb-2 text-neutral-1300">{title}</h3>
+          <p className="text-sm font-medium leading-relaxed tracking-normal text-neutral-800 dark:text-neutral-500 max-h-11 overflow-hidden">
+            {description}
+          </p>
+        </div>
+      </section>
+    </Link>
+  );
+};
+
+export const Tiles = ({ children }: { children: TileProps[] }) => {
+  return (
+    <div className="grid grid-cols-1 sm:grid-cols-2 gap-4 pb-40">
+      {children
+        .filter((item) => item.title && item.description)
+        .map((item: TileProps) => (
+          <Tile key={`${item.title}${item.description}`} {...item} />
+        ))}
+    </div>
+  );
+};