Merge pull request #510 from obytes/docs/upgrade-starlight-0.37

docs: upgrade Starlight to 0.37 and Astro to 5.17

Author: yjose

docs/astro.config.mjs

@@ -1,6 +1,5 @@
-import { defineConfig } from 'astro/config';
+import { defineConfig, passthroughImageService } from 'astro/config';
 import starlight from '@astrojs/starlight';
-import { pluginLineNumbers } from '@expressive-code/plugin-line-numbers';
 import starlightLlmsTxt from 'starlight-llms-txt';
 
 const site = 'https://starter.obytes.com/';
@@ -24,9 +23,9 @@ export default defineConfig({
       components: {
         LastUpdated: './src/components/LastUpdated.astro',
       },
-      social: {
-        github: 'https://github.com/obytes/react-native-template-obytes',
-      },
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/obytes/react-native-template-obytes' },
+      ],
       head: [
         {
           tag: 'meta',
@@ -232,10 +231,13 @@ export default defineConfig({
       lastUpdated: true,
     }),
   ],
-  // Process images with sharp: https://docs.astro.build/en/guides/assets/#using-sharp
   image: {
-    service: {
-      entrypoint: 'astro/assets/services/sharp',
+    service: passthroughImageService(),
+  },
+  // Prevent Vite from externalizing zod, which conflicts with the root project's zod@4
+  vite: {
+    ssr: {
+      noExternal: ['zod'],
     },
   },
 });

docs/ec.config.mjs

@@ -10,14 +10,13 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.31.1",
+    "@astrojs/starlight": "^0.37.6",
     "@expressive-code/plugin-collapsible-sections": "^0.33.4",
     "@expressive-code/plugin-line-numbers": "^0.33.4",
     "@fontsource/ibm-plex-mono": "^5.0.8",
     "@fontsource/ibm-plex-serif": "^5.0.8",
-    "astro": "^5.1.10",
+    "astro": "^5.17.1",
     "hast-util-to-html": "^9.0.0",
-    "sharp": "^0.32.3",
     "starlight-llms-txt": "^0.4.0"
   }
 }

docs/package.json

@@ -1,17 +1,16 @@
 ---
-import type { Props } from '@astrojs/starlight/props';
 import Default from '@astrojs/starlight/components/LastUpdated.astro';
 import Comments from './Comments.astro';
 
-const { lastUpdated } = Astro.props;
+const { lastUpdated } = Astro.locals.starlightRoute;
 
 ---
 
 {
 	lastUpdated && (
   <div class="container">
     <div class="last-updated">
-      <Default {...Astro.props}><slot /></Default>
+      <Default /><slot />
     </div>
     <Comments />
   </div>

docs/pnpm-lock.yaml

@@ -0,0 +1,8 @@
+import { defineCollection } from 'astro:content';
+import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
+import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+  i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
+};

docs/src/components/LastUpdated.astro

@@ -64,9 +64,9 @@ All actions are located in the `.github/actions` folder, and here is the complet
 
 <CodeBlock file=".github/workflows/new-github-release.yml" />
 
-### ⚙️ EAS Build QA
+### ⚙️ EAS Build Preview
 
-<CodeBlock file=".github/workflows/eas-build-qa.yml" />
+<CodeBlock file=".github/workflows/eas-build-preview.yml" />
 
 ### ⚙️ EAS Build Prod