From 503017bced3c71307910a73adc67c769610036ed Mon Sep 17 00:00:00 2001
From: tristandubbeld <tristan.dubbeld@gmail.com>
Date: Wed, 22 Oct 2025 16:47:56 +0200
Subject: [PATCH] feat(sdk): udpate getting started section for SDK users

---
 .../Content/routes/GetStarted/SDKRow.tsx      | 76 +++++++++++++++++++
 .../Content/routes/GetStarted/index.tsx       | 20 ++++-
 2 files changed, 92 insertions(+), 4 deletions(-)
 create mode 100644 packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/SDKRow.tsx

diff --git a/packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/SDKRow.tsx b/packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/SDKRow.tsx
new file mode 100644
index 00000000000..047c8ef6d4f
--- /dev/null
+++ b/packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/SDKRow.tsx
@@ -0,0 +1,76 @@
+import track from '@codesandbox/common/lib/utils/analytics';
+import { ArticleCard, Text, Stack } from '@codesandbox/components';
+import { Carousel } from 'app/pages/Dashboard/Components/Carousel/Carousel';
+import React from 'react';
+
+type ArticleProps = React.ComponentProps<typeof ArticleCard>;
+
+type DocsItem = { label: string } & ArticleProps;
+
+export const appendOnboardingTracking = (url: string): string => {
+  const baseUrl = new URL(url);
+  baseUrl.searchParams.append('utm_source', 'dashboard_onboarding');
+
+  return baseUrl.toString();
+};
+
+const DOCS: DocsItem[] = [
+  {
+    label: 'docs_sdk_core-concepts',
+    title: 'Core concepts',
+    url: 'https://codesandbox.io/docs/sdk/core-concepts',
+    thumbnail: '/static/img/thumbnails/docs_getting-started.png',
+  },
+  {
+    label: 'docs_sdk_manage-sandboxes',
+    title: 'Lifecycle management',
+    url: 'https://codesandbox.io/docs/sdk/manage-sandboxes',
+    thumbnail: '/static/img/thumbnails/youtube.png',
+  },
+  {
+    label: 'docs_sdk_templates',
+    title: 'Templates',
+    url: 'https://codesandbox.io/docs/sdk/templates',
+    thumbnail: '/static/img/thumbnails/blog_design-system.png',
+  },
+  {
+    label: 'docs_sdk_cli',
+    title: 'CLI Dashboard',
+    url: 'https://codesandbox.io/docs/sdk/cli',
+    thumbnail: '/static/img/thumbnails/video_command-palette.png',
+  },
+];
+
+export const SDKRow = () => {
+  const handleTrack = (label: string) => {
+    track('Empty State Card - Content card', {
+      codesandbox: 'V1',
+      event_source: 'UI',
+      card_type: label,
+    });
+  };
+
+  const items = DOCS.map(({ label, url, ...item }) => {
+    const urlWithTracking = appendOnboardingTracking(url);
+
+    return {
+      id: label,
+      Component: ArticleCard,
+      props: {
+        onClick: () => handleTrack(label),
+        url: urlWithTracking,
+        ...item,
+      },
+    };
+  });
+
+  return (
+    <Stack direction="vertical" gap={4}>
+      <Text as="h3" margin={0} size={4} weight="400">
+        Get started with the SDK
+      </Text>
+      <Carousel items={items} />
+    </Stack>
+  );
+};
+
diff --git a/packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/index.tsx b/packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/index.tsx
index 8243a2a437b..cd81ff4185c 100644
--- a/packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/index.tsx
+++ b/packages/app/src/app/pages/Dashboard/Content/routes/GetStarted/index.tsx
@@ -2,20 +2,32 @@ import React from 'react';
 import { Helmet } from 'react-helmet';
 import { StyledContentWrapper } from 'app/pages/Dashboard/Components/shared/elements';
 import { Element } from '@codesandbox/components';
+import { useActiveTeamInfo } from 'app/hooks/useActiveTeamInfo';
 import { InstructionsRow } from './InstructionsRow';
 import { DocumentationRow } from './DocumentationRow';
+import { SDKRow } from './SDKRow';
 
 export const GetStarted = () => {
+  const { sdkWorkspace } = useActiveTeamInfo();
+
   return (
     <StyledContentWrapper>
       <Helmet>
         <title>Get started - CodeSandbox</title>
       </Helmet>
 
-      <Element css={{ paddingTop: '8px' }}>
-        <InstructionsRow />
-      </Element>
-      <DocumentationRow />
+      {sdkWorkspace ? (
+        <Element css={{ paddingTop: '8px' }}>
+          <SDKRow />
+        </Element>
+      ) : (
+        <>
+          <Element css={{ paddingTop: '8px' }}>
+            <InstructionsRow />
+          </Element>
+          <DocumentationRow />
+        </>
+      )}
     </StyledContentWrapper>
   );
 };