feat(docs): configure Starlight site with Catppuccin theme

docs/site/astro.config.mjs

@@ -1,26 +1,22 @@
-// @ts-check
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
+import sidebar from './src/sidebar.json' with { type: 'json' };
 
-// https://astro.build/config
 export default defineConfig({
-	integrations: [
-		starlight({
-			title: 'My Docs',
-			social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/withastro/starlight' }],
-			sidebar: [
-				{
-					label: 'Guides',
-					items: [
-						// Each item here is one entry in the navigation menu.
-						{ label: 'Example Guide', slug: 'guides/example' },
-					],
-				},
-				{
-					label: 'Reference',
-					items: [{ autogenerate: { directory: 'reference' } }],
-				},
-			],
-		}),
-	],
+  site: 'https://fish-config.pages.dev',
+  integrations: [
+    starlight({
+      title: 'Fish Config',
+      description: 'Reference manual for the rootiest fish configuration.',
+      social: [
+        {
+          icon: 'code-branch',
+          label: 'Gitea',
+          href: 'https://git.rootiest.dev/rootiest/fish-config',
+        },
+      ],
+      customCss: ['./src/styles/catppuccin.css'],
+      sidebar,
+    }),
+  ],
 });

docs/site/src/styles/catppuccin.css

@@ -0,0 +1,28 @@
+/* Catppuccin Mocha (dark) / Latte (light) mapped onto Starlight tokens. */
+:root {
+  --sl-color-accent-low: #1e1e2e;
+  --sl-color-accent: #89b4fa;
+  --sl-color-accent-high: #b4befe;
+  --sl-color-white: #cdd6f4;
+  --sl-color-gray-1: #bac2de;
+  --sl-color-gray-2: #a6adc8;
+  --sl-color-gray-3: #7f849c;
+  --sl-color-gray-4: #585b70;
+  --sl-color-gray-5: #45475a;
+  --sl-color-gray-6: #313244;
+  --sl-color-black: #181825;
+}
+
+:root[data-theme='light'] {
+  --sl-color-accent-low: #dce0e8;
+  --sl-color-accent: #1e66f5;
+  --sl-color-accent-high: #7287fd;
+  --sl-color-white: #4c4f69;
+  --sl-color-gray-1: #5c5f77;
+  --sl-color-gray-2: #6c6f85;
+  --sl-color-gray-3: #7c7f93;
+  --sl-color-gray-4: #9ca0b0;
+  --sl-color-gray-5: #bcc0cc;
+  --sl-color-gray-6: #ccd0da;
+  --sl-color-black: #eff1f5;
+}