diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index 55dd1c2c..49bbf260 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -3,6 +3,7 @@ import starlight from '@astrojs/starlight';
 import mdx from '@astrojs/mdx';
 import sitemap from '@astrojs/sitemap';
 import { pluginLineNumbers } from '@expressive-code/plugin-line-numbers';
+import { starlightBasePath } from 'starlight-base-path';
 import starlightLinksValidator from 'starlight-links-validator';
 import starlightScrollToTop from 'starlight-scroll-to-top';
 import starlightAnnouncement from 'starlight-announcement';
@@ -21,6 +22,7 @@ export default defineConfig({
 	integrations: [
 		starlight({
 			plugins: [
+				starlightBasePath(),
 				starlightLinksValidator({
 					errorOnFallbackPages: false,
 				}),
diff --git a/docs/package-lock.json b/docs/package-lock.json
index ed57321f..1bae5d0a 100644
--- a/docs/package-lock.json
+++ b/docs/package-lock.json
@@ -18,10 +18,12 @@
 				"mermaid": "^11.17.2",
 				"sharp": "^0.35.3",
 				"starlight-announcement": "^2.0.0",
+				"starlight-base-path": "^0.2.1",
 				"starlight-fullview-mode": "^0.2.6",
 				"starlight-links-validator": "^0.26.0",
 				"starlight-plugin-icons": "^1.1.6",
 				"starlight-scroll-to-top": "^2.0.0",
+				"unist-util-visit": "^5.1.0",
 				"unocss": "^66.10.5"
 			}
 		},
@@ -8523,6 +8525,24 @@
 				"@astrojs/starlight": ">=0.41.0"
 			}
 		},
+		"node_modules/starlight-base-path": {
+			"version": "0.2.1",
+			"resolved": "https://registry.npmjs.org/starlight-base-path/-/starlight-base-path-0.2.1.tgz",
+			"integrity": "sha512-BMxM3E3BdIUDRW3yYmqXbtnSQyusI4t6NmG0+Bi/ETPMZmVJywr8WTwaW5NJJ0l2YWoKc8yedvpiDpQKpokD/A==",
+			"dependencies": {
+				"unist-util-visit": "^5.0.0"
+			},
+			"peerDependencies": {
+				"@astrojs/markdown-remark": ">=7.0.0",
+				"@astrojs/starlight": ">=0.38.0",
+				"astro": ">=6.0.0"
+			},
+			"peerDependenciesMeta": {
+				"@astrojs/markdown-remark": {
+					"optional": true
+				}
+			}
+		},
 		"node_modules/starlight-fullview-mode": {
 			"version": "0.2.6",
 			"resolved": "https://registry.npmjs.org/starlight-fullview-mode/-/starlight-fullview-mode-0.2.6.tgz",
diff --git a/docs/package.json b/docs/package.json
index 80f292dd..1ac4bee6 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -23,11 +23,12 @@
 		"mermaid": "^11.17.2",
 		"sharp": "^0.35.3",
 		"starlight-announcement": "^2.0.0",
+		"starlight-base-path": "^0.2.1",
 		"starlight-fullview-mode": "^0.2.6",
 		"starlight-links-validator": "^0.26.0",
 		"starlight-plugin-icons": "^1.1.6",
 		"starlight-scroll-to-top": "^2.0.0",
-		"unocss": "^66.10.5",
-		"unist-util-visit": "^5.1.0"
+		"unist-util-visit": "^5.1.0",
+		"unocss": "^66.10.5"
 	}
 }
diff --git a/docs/src/content/docs/en/index.mdx b/docs/src/content/docs/en/index.mdx
index c846f0b5..9e5ec760 100644
--- a/docs/src/content/docs/en/index.mdx
+++ b/docs/src/content/docs/en/index.mdx
@@ -19,20 +19,22 @@ hero:
 import { Card, CardGrid } from '@astrojs/starlight/components';
 import { ContributorList } from 'astro-contributors';
 
+export const base = import.meta.env.BASE_URL.replace(/\/$/, '');
+
 ## Discover the documentation
 
 <CardGrid stagger>
-	<a href="/en/guides/getting-started/" class="card-link">
+	<a href={`${base}/en/guides/getting-started/`} class="card-link">
 		<Card title="Getting started" icon="rocket">
 			Step-by-step installation with XMake and Clang, and building your first modular C++26 program.
 		</Card>
 	</a>
-	<a href="/en/guides/lockers/" class="card-link">
+	<a href={`${base}/en/guides/lockers/`} class="card-link">
 		<Card title="RAII synchronization" icon="pencil">
 			Practical guide to using `UniqueLocker` and `SharedLocker` to safely protect shared resources.
 		</Card>
 	</a>
-	<a href="/en/reference/" class="card-link">
+	<a href={`${base}/en/reference/`} class="card-link">
 		<Card title="C++ API reference" icon="open-book">
 			Full function signatures, method descriptions, move semantics, and RAII accessor classes.
 		</Card>
diff --git a/docs/src/content/docs/fr/index.mdx b/docs/src/content/docs/fr/index.mdx
index d2e26504..943ba73b 100644
--- a/docs/src/content/docs/fr/index.mdx
+++ b/docs/src/content/docs/fr/index.mdx
@@ -19,20 +19,22 @@ hero:
 import { Card, CardGrid } from '@astrojs/starlight/components';
 import { ContributorList } from 'astro-contributors';
 
+export const base = import.meta.env.BASE_URL.replace(/\/$/, '');
+
 ## Découvrir la documentation
 
 <CardGrid stagger>
-	<a href="/fr/guides/getting-started/" class="card-link">
+	<a href={`${base}/fr/guides/getting-started/`} class="card-link">
 		<Card title="Prise en main" icon="rocket">
 			Installation pas-à-pas avec XMake et Clang, et compilation de votre premier programme modulaire C++26.
 		</Card>
 	</a>
-	<a href="/fr/guides/lockers/" class="card-link">
+	<a href={`${base}/fr/guides/lockers/`} class="card-link">
 		<Card title="Synchronisation RAII" icon="pencil">
 			Guide pratique pour utiliser `UniqueLocker` et `SharedLocker` afin de sécuriser l'accès aux données partagées.
 		</Card>
 	</a>
-	<a href="/fr/reference/" class="card-link">
+	<a href={`${base}/fr/reference/`} class="card-link">
 		<Card title="Référence d'API C++" icon="open-book">
 			Signatures complètes, descriptions de méthodes, sémantique de déplacement et classes d'accès.
 		</Card>