From 44e291c18fa9405f89e97d12ce0510349df1663b Mon Sep 17 00:00:00 2001
From: Mattias Buelens <mattias.buelens@theoplayer.com>
Date: Thu, 2 Apr 2026 16:45:43 +0200
Subject: [PATCH 1/5] Fix getPlatformsByVersion calls

---
 theoplayer/getting-started/index.mdx                           | 2 +-
 theoplayer/index.mdx                                           | 2 +-
 theoplayer_versioned_docs/version-v8/getting-started/index.mdx | 2 +-
 theoplayer_versioned_docs/version-v8/index.mdx                 | 2 +-
 theoplayer_versioned_docs/version-v9/getting-started/index.mdx | 2 +-
 theoplayer_versioned_docs/version-v9/index.mdx                 | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/theoplayer/getting-started/index.mdx b/theoplayer/getting-started/index.mdx
index 70cd89638e9d..9a1020264820 100644
--- a/theoplayer/getting-started/index.mdx
+++ b/theoplayer/getting-started/index.mdx
@@ -17,7 +17,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 import { getPlatformsByVersion } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => {
+  items={getPlatformsByVersion('theoplayer', 'v11').map((desc) => {
     const href =
       desc.platform === 'react-native' || desc.platform === 'flutter'
         ? `theoplayer/getting-started/frameworks/${desc.platform}/getting-started`
diff --git a/theoplayer/index.mdx b/theoplayer/index.mdx
index c1d76174201b..52812b68ce30 100644
--- a/theoplayer/index.mdx
+++ b/theoplayer/index.mdx
@@ -13,7 +13,7 @@ import { getPlatformsByVersion } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => ({
+  items={getPlatformsByVersion('theoplayer', 'v11').map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
diff --git a/theoplayer_versioned_docs/version-v8/getting-started/index.mdx b/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
index 70cd89638e9d..5eceac23bdd6 100644
--- a/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
@@ -17,7 +17,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 import { getPlatformsByVersion } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => {
+  items={getPlatformsByVersion('theoplayer', 'v8').map((desc) => {
     const href =
       desc.platform === 'react-native' || desc.platform === 'flutter'
         ? `theoplayer/getting-started/frameworks/${desc.platform}/getting-started`
diff --git a/theoplayer_versioned_docs/version-v8/index.mdx b/theoplayer_versioned_docs/version-v8/index.mdx
index c1d76174201b..335dcdb08318 100644
--- a/theoplayer_versioned_docs/version-v8/index.mdx
+++ b/theoplayer_versioned_docs/version-v8/index.mdx
@@ -13,7 +13,7 @@ import { getPlatformsByVersion } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => ({
+  items={getPlatformsByVersion('theoplayer', 'v8').map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
diff --git a/theoplayer_versioned_docs/version-v9/getting-started/index.mdx b/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
index 70cd89638e9d..981ae44458f7 100644
--- a/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
@@ -17,7 +17,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 import { getPlatformsByVersion } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => {
+  items={getPlatformsByVersion('theoplayer', 'v9').map((desc) => {
     const href =
       desc.platform === 'react-native' || desc.platform === 'flutter'
         ? `theoplayer/getting-started/frameworks/${desc.platform}/getting-started`
diff --git a/theoplayer_versioned_docs/version-v9/index.mdx b/theoplayer_versioned_docs/version-v9/index.mdx
index c1d76174201b..f687863dac41 100644
--- a/theoplayer_versioned_docs/version-v9/index.mdx
+++ b/theoplayer_versioned_docs/version-v9/index.mdx
@@ -13,7 +13,7 @@ import { getPlatformsByVersion } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => ({
+  items={getPlatformsByVersion('theoplayer', 'v9').map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,

From 14f38f14763a2d7f8f124adaf493b1ca0cd0e881 Mon Sep 17 00:00:00 2001
From: Mattias Buelens <mattias.buelens@theoplayer.com>
Date: Thu, 2 Apr 2026 16:56:24 +0200
Subject: [PATCH 2/5] Fix versioned links

---
 theoplayer_versioned_docs/version-v7/index.mdx | 2 +-
 theoplayer_versioned_docs/version-v8/index.mdx | 2 +-
 theoplayer_versioned_docs/version-v9/index.mdx | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/theoplayer_versioned_docs/version-v7/index.mdx b/theoplayer_versioned_docs/version-v7/index.mdx
index c1d76174201b..f9f8f78e4897 100644
--- a/theoplayer_versioned_docs/version-v7/index.mdx
+++ b/theoplayer_versioned_docs/version-v7/index.mdx
@@ -18,6 +18,6 @@ import { getPlatformsByVersion } from '@site/src/util/platform';
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/${desc.platform}`),
+    href: useBaseUrl(`theoplayer/v7/${desc.platform}`),
   }))}
 />
diff --git a/theoplayer_versioned_docs/version-v8/index.mdx b/theoplayer_versioned_docs/version-v8/index.mdx
index 335dcdb08318..f7b6d9d15ae3 100644
--- a/theoplayer_versioned_docs/version-v8/index.mdx
+++ b/theoplayer_versioned_docs/version-v8/index.mdx
@@ -18,6 +18,6 @@ import { getPlatformsByVersion } from '@site/src/util/platform';
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/${desc.platform}`),
+    href: useBaseUrl(`theoplayer/v8/${desc.platform}`),
   }))}
 />
diff --git a/theoplayer_versioned_docs/version-v9/index.mdx b/theoplayer_versioned_docs/version-v9/index.mdx
index f687863dac41..772d4a998801 100644
--- a/theoplayer_versioned_docs/version-v9/index.mdx
+++ b/theoplayer_versioned_docs/version-v9/index.mdx
@@ -18,6 +18,6 @@ import { getPlatformsByVersion } from '@site/src/util/platform';
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/${desc.platform}`),
+    href: useBaseUrl(`theoplayer/v9/${desc.platform}`),
   }))}
 />

From f1d37a370eaef5ca46fb1ca2daa00d87ed95f1a6 Mon Sep 17 00:00:00 2001
From: Mattias Buelens <mattias.buelens@theoplayer.com>
Date: Thu, 2 Apr 2026 17:09:35 +0200
Subject: [PATCH 3/5] Add `usePlatforms` helper

---
 src/util/platform.ts                           | 17 ++++++++++++++++-
 theoplayer/index.mdx                           |  7 +++----
 theoplayer_versioned_docs/version-v4/index.mdx |  7 +++----
 theoplayer_versioned_docs/version-v6/index.mdx |  7 +++----
 theoplayer_versioned_docs/version-v7/index.mdx |  7 +++----
 theoplayer_versioned_docs/version-v8/index.mdx |  7 +++----
 theoplayer_versioned_docs/version-v9/index.mdx |  7 +++----
 7 files changed, 34 insertions(+), 25 deletions(-)

diff --git a/src/util/platform.ts b/src/util/platform.ts
index 65a67d9101d2..dde64e410550 100644
--- a/src/util/platform.ts
+++ b/src/util/platform.ts
@@ -1,4 +1,5 @@
-import type { GlobalDoc, GlobalVersion } from '@docusaurus/plugin-content-docs/client';
+import { type GlobalDoc, type GlobalVersion, useActivePluginAndVersion } from '@docusaurus/plugin-content-docs/client';
+import { useBaseUrlUtils } from '@docusaurus/useBaseUrl';
 
 /**
  * The names of SDK platforms.
@@ -23,6 +24,10 @@ interface PlatformDescription {
   minVersion: number;
 }
 
+interface PlatformDescriptionWithUrl extends PlatformDescription {
+  baseUrl: string;
+}
+
 const theoplayerPlatforms: readonly PlatformDescription[] = [
   {
     platform: 'web',
@@ -133,6 +138,16 @@ export function getPlatformsByVersion(docsPluginId: string, version?: string): r
   return platforms;
 }
 
+export function usePlatforms(): readonly PlatformDescriptionWithUrl[] {
+  const { activePlugin, activeVersion } = useActivePluginAndVersion({ failfast: true });
+  const { withBaseUrl } = useBaseUrlUtils();
+  if (!activeVersion) return [];
+  return getPlatformsByVersion(activePlugin.pluginId, activeVersion.name).map((desc) => ({
+    ...desc,
+    baseUrl: withBaseUrl(`${activeVersion.path}/${desc.platform}`),
+  }));
+}
+
 type PlatformDescriptionsByName = Record<PlatformName, PlatformDescription>;
 const theoplayerPlatformsByName = Object.fromEntries(theoplayerPlatforms.map((desc) => [desc.platform, desc])) as PlatformDescriptionsByName;
 const openVideoUiPlatformsByName = Object.fromEntries(openVideoUiPlatforms.map((desc) => [desc.platform, desc])) as PlatformDescriptionsByName;
diff --git a/theoplayer/index.mdx b/theoplayer/index.mdx
index 52812b68ce30..856d5cba19c7 100644
--- a/theoplayer/index.mdx
+++ b/theoplayer/index.mdx
@@ -8,16 +8,15 @@ sidebar_position: 1
 
 import Intro from './shared/_intro.mdx';
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v11').map((desc) => ({
+  items={usePlatforms().map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/${desc.platform}`),
+    href: desc.baseUrl,
   }))}
 />
diff --git a/theoplayer_versioned_docs/version-v4/index.mdx b/theoplayer_versioned_docs/version-v4/index.mdx
index 738c4b51294f..856d5cba19c7 100644
--- a/theoplayer_versioned_docs/version-v4/index.mdx
+++ b/theoplayer_versioned_docs/version-v4/index.mdx
@@ -8,16 +8,15 @@ sidebar_position: 1
 
 import Intro from './shared/_intro.mdx';
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v4').map((desc) => ({
+  items={usePlatforms().map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/v4/${desc.platform}`),
+    href: desc.baseUrl,
   }))}
 />
diff --git a/theoplayer_versioned_docs/version-v6/index.mdx b/theoplayer_versioned_docs/version-v6/index.mdx
index 6861cf1ba84a..856d5cba19c7 100644
--- a/theoplayer_versioned_docs/version-v6/index.mdx
+++ b/theoplayer_versioned_docs/version-v6/index.mdx
@@ -8,16 +8,15 @@ sidebar_position: 1
 
 import Intro from './shared/_intro.mdx';
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v6').map((desc) => ({
+  items={usePlatforms().map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/v6/${desc.platform}`),
+    href: desc.baseUrl,
   }))}
 />
diff --git a/theoplayer_versioned_docs/version-v7/index.mdx b/theoplayer_versioned_docs/version-v7/index.mdx
index f9f8f78e4897..856d5cba19c7 100644
--- a/theoplayer_versioned_docs/version-v7/index.mdx
+++ b/theoplayer_versioned_docs/version-v7/index.mdx
@@ -8,16 +8,15 @@ sidebar_position: 1
 
 import Intro from './shared/_intro.mdx';
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => ({
+  items={usePlatforms().map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/v7/${desc.platform}`),
+    href: desc.baseUrl,
   }))}
 />
diff --git a/theoplayer_versioned_docs/version-v8/index.mdx b/theoplayer_versioned_docs/version-v8/index.mdx
index f7b6d9d15ae3..856d5cba19c7 100644
--- a/theoplayer_versioned_docs/version-v8/index.mdx
+++ b/theoplayer_versioned_docs/version-v8/index.mdx
@@ -8,16 +8,15 @@ sidebar_position: 1
 
 import Intro from './shared/_intro.mdx';
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v8').map((desc) => ({
+  items={usePlatforms().map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/v8/${desc.platform}`),
+    href: desc.baseUrl,
   }))}
 />
diff --git a/theoplayer_versioned_docs/version-v9/index.mdx b/theoplayer_versioned_docs/version-v9/index.mdx
index 772d4a998801..856d5cba19c7 100644
--- a/theoplayer_versioned_docs/version-v9/index.mdx
+++ b/theoplayer_versioned_docs/version-v9/index.mdx
@@ -8,16 +8,15 @@ sidebar_position: 1
 
 import Intro from './shared/_intro.mdx';
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <Intro />
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v9').map((desc) => ({
+  items={usePlatforms().map((desc) => ({
     type: 'link',
     label: desc.label,
     description: desc.description,
     customProps: { icon: desc.icon },
-    href: useBaseUrl(`theoplayer/v9/${desc.platform}`),
+    href: desc.baseUrl,
   }))}
 />

From 25ce95a6e14ca34dd063a4968525a7bcae21fa19 Mon Sep 17 00:00:00 2001
From: Mattias Buelens <mattias.buelens@theoplayer.com>
Date: Thu, 2 Apr 2026 17:18:27 +0200
Subject: [PATCH 4/5] Rework getting started overview page

---
 src/util/platform.ts                               | 14 ++++++++++++++
 theoplayer/getting-started/index.mdx               | 11 +++--------
 .../version-v4/getting-started/index.mdx           | 11 +++--------
 .../version-v6/getting-started/index.mdx           | 11 +++--------
 .../version-v7/getting-started/index.mdx           | 11 +++--------
 .../version-v8/getting-started/index.mdx           | 11 +++--------
 .../version-v9/getting-started/index.mdx           | 11 +++--------
 7 files changed, 32 insertions(+), 48 deletions(-)

diff --git a/src/util/platform.ts b/src/util/platform.ts
index dde64e410550..1a0d61e07797 100644
--- a/src/util/platform.ts
+++ b/src/util/platform.ts
@@ -20,12 +20,14 @@ interface PlatformDescription {
   label: string;
   shortLabel?: string;
   description: string;
+  gettingStartedDoc: string;
   icon: string;
   minVersion: number;
 }
 
 interface PlatformDescriptionWithUrl extends PlatformDescription {
   baseUrl: string;
+  gettingStartedDocUrl: string;
 }
 
 const theoplayerPlatforms: readonly PlatformDescription[] = [
@@ -34,6 +36,7 @@ const theoplayerPlatforms: readonly PlatformDescription[] = [
     label: 'THEOplayer Web SDK',
     shortLabel: 'Web SDK',
     description: 'For desktop and mobile web browsers, and smart TVs like Tizen and WebOS',
+    gettingStartedDoc: 'getting-started/sdks/web/getting-started',
     icon: 'web',
     minVersion: 1,
   },
@@ -42,6 +45,7 @@ const theoplayerPlatforms: readonly PlatformDescription[] = [
     label: 'THEOplayer Android SDK',
     shortLabel: 'Android SDK',
     description: 'For smartphones, tablets and Android TVs',
+    gettingStartedDoc: 'getting-started/sdks/android/getting-started',
     icon: 'android',
     minVersion: 1,
   },
@@ -50,6 +54,7 @@ const theoplayerPlatforms: readonly PlatformDescription[] = [
     label: 'THEOplayer iOS & tvOS SDK',
     shortLabel: 'iOS & tvOS SDK',
     description: 'For iPhone, iPad and Apple TV',
+    gettingStartedDoc: 'getting-started/sdks/ios/getting-started',
     icon: 'apple',
     minVersion: 1,
   },
@@ -58,6 +63,7 @@ const theoplayerPlatforms: readonly PlatformDescription[] = [
     label: 'THEOplayer React Native SDK',
     shortLabel: 'React Native SDK',
     description: 'For cross-platform apps targeting web, Android and iOS',
+    gettingStartedDoc: 'getting-started/frameworks/react-native/getting-started',
     icon: 'react',
     minVersion: 1,
   },
@@ -66,6 +72,7 @@ const theoplayerPlatforms: readonly PlatformDescription[] = [
     label: 'THEOplayer Flutter SDK',
     shortLabel: 'Flutter SDK',
     description: 'For cross-platform apps targeting web, Android and iOS',
+    gettingStartedDoc: 'getting-started/frameworks/flutter/getting-started',
     icon: 'flutter',
     minVersion: 7,
   },
@@ -74,6 +81,7 @@ const theoplayerPlatforms: readonly PlatformDescription[] = [
     label: 'THEOplayer Chromecast SDK',
     shortLabel: 'Chromecast SDK',
     description: 'For custom Chromecast receiver apps',
+    gettingStartedDoc: 'getting-started/sdks/chromecast/getting-started',
     icon: 'chromecast',
     minVersion: 1,
   },
@@ -82,6 +90,7 @@ const theoplayerPlatforms: readonly PlatformDescription[] = [
     label: 'THEOplayer Roku SDK',
     shortLabel: 'Roku SDK',
     description: 'For Roku smart TVs',
+    gettingStartedDoc: 'getting-started/sdks/roku/getting-started',
     icon: 'roku',
     minVersion: 1,
   },
@@ -92,6 +101,7 @@ const openVideoUiPlatforms: readonly PlatformDescription[] = [
     platform: 'web',
     label: 'Open Video UI for Web',
     description: 'For desktop and mobile web browsers using Web Components',
+    gettingStartedDoc: 'web/getting-started',
     icon: 'web',
     minVersion: 1,
   },
@@ -99,6 +109,7 @@ const openVideoUiPlatforms: readonly PlatformDescription[] = [
     platform: 'android',
     label: 'Open Video UI for Android',
     description: 'For Android smartphones and tablets using Jetpack Compose',
+    gettingStartedDoc: 'android/getting-started',
     icon: 'android',
     minVersion: 1,
   },
@@ -106,6 +117,7 @@ const openVideoUiPlatforms: readonly PlatformDescription[] = [
     platform: 'react',
     label: 'Open Video UI for React',
     description: 'For web apps using React components',
+    gettingStartedDoc: 'react/getting-started',
     icon: 'react',
     minVersion: 1,
   },
@@ -114,6 +126,7 @@ const openVideoUiPlatforms: readonly PlatformDescription[] = [
     label: 'React Native THEOplayer UI',
     shortLabel: 'React Native UI',
     description: 'For cross-platform apps using React Native components',
+    gettingStartedDoc: 'react-native/getting-started',
     icon: 'react',
     minVersion: 1,
   },
@@ -145,6 +158,7 @@ export function usePlatforms(): readonly PlatformDescriptionWithUrl[] {
   return getPlatformsByVersion(activePlugin.pluginId, activeVersion.name).map((desc) => ({
     ...desc,
     baseUrl: withBaseUrl(`${activeVersion.path}/${desc.platform}`),
+    gettingStartedDocUrl: withBaseUrl(`${activeVersion.path}/${desc.gettingStartedDoc}`),
   }));
 }
 
diff --git a/theoplayer/getting-started/index.mdx b/theoplayer/getting-started/index.mdx
index 9a1020264820..baf6c5125863 100644
--- a/theoplayer/getting-started/index.mdx
+++ b/theoplayer/getting-started/index.mdx
@@ -13,20 +13,15 @@ Our dedicated guides help you get started right away.
 </head>
 
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v11').map((desc) => {
-    const href =
-      desc.platform === 'react-native' || desc.platform === 'flutter'
-        ? `theoplayer/getting-started/frameworks/${desc.platform}/getting-started`
-        : `theoplayer/getting-started/sdks/${desc.platform}/getting-started`;
+  items={usePlatforms().map((desc) => {
     return {
       type: 'link',
       label: desc.label,
       customProps: { icon: desc.icon },
-      href: useBaseUrl(href),
+      href: desc.gettingStartedDocUrl,
     };
   })}
 />
diff --git a/theoplayer_versioned_docs/version-v4/getting-started/index.mdx b/theoplayer_versioned_docs/version-v4/getting-started/index.mdx
index e5c3cf3c7b3d..baf6c5125863 100644
--- a/theoplayer_versioned_docs/version-v4/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v4/getting-started/index.mdx
@@ -13,20 +13,15 @@ Our dedicated guides help you get started right away.
 </head>
 
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v4').map((desc) => {
-    const href =
-      desc.platform === 'react-native' || desc.platform === 'flutter'
-        ? `theoplayer/v4/getting-started/frameworks/${desc.platform}/getting-started`
-        : `theoplayer/v4/getting-started/sdks/${desc.platform}/getting-started`;
+  items={usePlatforms().map((desc) => {
     return {
       type: 'link',
       label: desc.label,
       customProps: { icon: desc.icon },
-      href: useBaseUrl(href),
+      href: desc.gettingStartedDocUrl,
     };
   })}
 />
diff --git a/theoplayer_versioned_docs/version-v6/getting-started/index.mdx b/theoplayer_versioned_docs/version-v6/getting-started/index.mdx
index c09046916250..baf6c5125863 100644
--- a/theoplayer_versioned_docs/version-v6/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v6/getting-started/index.mdx
@@ -13,20 +13,15 @@ Our dedicated guides help you get started right away.
 </head>
 
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v6').map((desc) => {
-    const href =
-      desc.platform === 'react-native' || desc.platform === 'flutter'
-        ? `theoplayer/v6/getting-started/frameworks/${desc.platform}/getting-started`
-        : `theoplayer/v6/getting-started/sdks/${desc.platform}/getting-started`;
+  items={usePlatforms().map((desc) => {
     return {
       type: 'link',
       label: desc.label,
       customProps: { icon: desc.icon },
-      href: useBaseUrl(href),
+      href: desc.gettingStartedDocUrl,
     };
   })}
 />
diff --git a/theoplayer_versioned_docs/version-v7/getting-started/index.mdx b/theoplayer_versioned_docs/version-v7/getting-started/index.mdx
index 70cd89638e9d..baf6c5125863 100644
--- a/theoplayer_versioned_docs/version-v7/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v7/getting-started/index.mdx
@@ -13,20 +13,15 @@ Our dedicated guides help you get started right away.
 </head>
 
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v7').map((desc) => {
-    const href =
-      desc.platform === 'react-native' || desc.platform === 'flutter'
-        ? `theoplayer/getting-started/frameworks/${desc.platform}/getting-started`
-        : `theoplayer/getting-started/sdks/${desc.platform}/getting-started`;
+  items={usePlatforms().map((desc) => {
     return {
       type: 'link',
       label: desc.label,
       customProps: { icon: desc.icon },
-      href: useBaseUrl(href),
+      href: desc.gettingStartedDocUrl,
     };
   })}
 />
diff --git a/theoplayer_versioned_docs/version-v8/getting-started/index.mdx b/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
index 5eceac23bdd6..baf6c5125863 100644
--- a/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
@@ -13,20 +13,15 @@ Our dedicated guides help you get started right away.
 </head>
 
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v8').map((desc) => {
-    const href =
-      desc.platform === 'react-native' || desc.platform === 'flutter'
-        ? `theoplayer/getting-started/frameworks/${desc.platform}/getting-started`
-        : `theoplayer/getting-started/sdks/${desc.platform}/getting-started`;
+  items={usePlatforms().map((desc) => {
     return {
       type: 'link',
       label: desc.label,
       customProps: { icon: desc.icon },
-      href: useBaseUrl(href),
+      href: desc.gettingStartedDocUrl,
     };
   })}
 />
diff --git a/theoplayer_versioned_docs/version-v9/getting-started/index.mdx b/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
index 981ae44458f7..baf6c5125863 100644
--- a/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
@@ -13,20 +13,15 @@ Our dedicated guides help you get started right away.
 </head>
 
 import DocCardList from '@theme/DocCardList';
-import useBaseUrl from '@docusaurus/useBaseUrl';
-import { getPlatformsByVersion } from '@site/src/util/platform';
+import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={getPlatformsByVersion('theoplayer', 'v9').map((desc) => {
-    const href =
-      desc.platform === 'react-native' || desc.platform === 'flutter'
-        ? `theoplayer/getting-started/frameworks/${desc.platform}/getting-started`
-        : `theoplayer/getting-started/sdks/${desc.platform}/getting-started`;
+  items={usePlatforms().map((desc) => {
     return {
       type: 'link',
       label: desc.label,
       customProps: { icon: desc.icon },
-      href: useBaseUrl(href),
+      href: desc.gettingStartedDocUrl,
     };
   })}
 />

From b1893dbab8ef141eb4cf1cdf6a8578b2b9d9f104 Mon Sep 17 00:00:00 2001
From: Mattias Buelens <mattias.buelens@theoplayer.com>
Date: Thu, 2 Apr 2026 17:28:15 +0200
Subject: [PATCH 5/5] Reformat

---
 theoplayer/getting-started/index.mdx               | 14 ++++++--------
 .../version-v4/getting-started/index.mdx           | 14 ++++++--------
 .../version-v6/getting-started/index.mdx           | 14 ++++++--------
 .../version-v7/getting-started/index.mdx           | 14 ++++++--------
 .../version-v8/getting-started/index.mdx           | 14 ++++++--------
 .../version-v9/getting-started/index.mdx           | 14 ++++++--------
 6 files changed, 36 insertions(+), 48 deletions(-)

diff --git a/theoplayer/getting-started/index.mdx b/theoplayer/getting-started/index.mdx
index baf6c5125863..f0b85addb311 100644
--- a/theoplayer/getting-started/index.mdx
+++ b/theoplayer/getting-started/index.mdx
@@ -16,12 +16,10 @@ import DocCardList from '@theme/DocCardList';
 import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={usePlatforms().map((desc) => {
-    return {
-      type: 'link',
-      label: desc.label,
-      customProps: { icon: desc.icon },
-      href: desc.gettingStartedDocUrl,
-    };
-  })}
+  items={usePlatforms().map((desc) => ({
+    type: 'link',
+    label: desc.label,
+    customProps: { icon: desc.icon },
+    href: desc.gettingStartedDocUrl,
+  }))}
 />
diff --git a/theoplayer_versioned_docs/version-v4/getting-started/index.mdx b/theoplayer_versioned_docs/version-v4/getting-started/index.mdx
index baf6c5125863..f0b85addb311 100644
--- a/theoplayer_versioned_docs/version-v4/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v4/getting-started/index.mdx
@@ -16,12 +16,10 @@ import DocCardList from '@theme/DocCardList';
 import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={usePlatforms().map((desc) => {
-    return {
-      type: 'link',
-      label: desc.label,
-      customProps: { icon: desc.icon },
-      href: desc.gettingStartedDocUrl,
-    };
-  })}
+  items={usePlatforms().map((desc) => ({
+    type: 'link',
+    label: desc.label,
+    customProps: { icon: desc.icon },
+    href: desc.gettingStartedDocUrl,
+  }))}
 />
diff --git a/theoplayer_versioned_docs/version-v6/getting-started/index.mdx b/theoplayer_versioned_docs/version-v6/getting-started/index.mdx
index baf6c5125863..f0b85addb311 100644
--- a/theoplayer_versioned_docs/version-v6/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v6/getting-started/index.mdx
@@ -16,12 +16,10 @@ import DocCardList from '@theme/DocCardList';
 import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={usePlatforms().map((desc) => {
-    return {
-      type: 'link',
-      label: desc.label,
-      customProps: { icon: desc.icon },
-      href: desc.gettingStartedDocUrl,
-    };
-  })}
+  items={usePlatforms().map((desc) => ({
+    type: 'link',
+    label: desc.label,
+    customProps: { icon: desc.icon },
+    href: desc.gettingStartedDocUrl,
+  }))}
 />
diff --git a/theoplayer_versioned_docs/version-v7/getting-started/index.mdx b/theoplayer_versioned_docs/version-v7/getting-started/index.mdx
index baf6c5125863..f0b85addb311 100644
--- a/theoplayer_versioned_docs/version-v7/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v7/getting-started/index.mdx
@@ -16,12 +16,10 @@ import DocCardList from '@theme/DocCardList';
 import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={usePlatforms().map((desc) => {
-    return {
-      type: 'link',
-      label: desc.label,
-      customProps: { icon: desc.icon },
-      href: desc.gettingStartedDocUrl,
-    };
-  })}
+  items={usePlatforms().map((desc) => ({
+    type: 'link',
+    label: desc.label,
+    customProps: { icon: desc.icon },
+    href: desc.gettingStartedDocUrl,
+  }))}
 />
diff --git a/theoplayer_versioned_docs/version-v8/getting-started/index.mdx b/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
index baf6c5125863..f0b85addb311 100644
--- a/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v8/getting-started/index.mdx
@@ -16,12 +16,10 @@ import DocCardList from '@theme/DocCardList';
 import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={usePlatforms().map((desc) => {
-    return {
-      type: 'link',
-      label: desc.label,
-      customProps: { icon: desc.icon },
-      href: desc.gettingStartedDocUrl,
-    };
-  })}
+  items={usePlatforms().map((desc) => ({
+    type: 'link',
+    label: desc.label,
+    customProps: { icon: desc.icon },
+    href: desc.gettingStartedDocUrl,
+  }))}
 />
diff --git a/theoplayer_versioned_docs/version-v9/getting-started/index.mdx b/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
index baf6c5125863..f0b85addb311 100644
--- a/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
+++ b/theoplayer_versioned_docs/version-v9/getting-started/index.mdx
@@ -16,12 +16,10 @@ import DocCardList from '@theme/DocCardList';
 import { usePlatforms } from '@site/src/util/platform';
 
 <DocCardList
-  items={usePlatforms().map((desc) => {
-    return {
-      type: 'link',
-      label: desc.label,
-      customProps: { icon: desc.icon },
-      href: desc.gettingStartedDocUrl,
-    };
-  })}
+  items={usePlatforms().map((desc) => ({
+    type: 'link',
+    label: desc.label,
+    customProps: { icon: desc.icon },
+    href: desc.gettingStartedDocUrl,
+  }))}
 />