Fix TutorialLayout crash for tutorials without optional fields

hxrshxz · doradocodes · commit 0e1c1fa865be · 2026-03-30T12:08:44.000-04:00
diff --git a/src/content/tutorials/config.ts b/src/content/tutorials/config.ts
@@ -19,19 +19,37 @@ export const categories = [
 export const tutorialsCollection = defineCollection({
   type: "content",
   schema: ({ image }) =>
-    z.object({
-      // Title of the tutorial
-      title: z.string(),
-      // People who wrote the tutorial
-      authors: z.array(z.string()).optional(),
-      // Optional note explaining more context about the authors
-      authorsNote: z.string().optional(),
-      description: z.string().optional(),
-      category: z.enum(categories),
-      categoryIndex: z.number().optional(),
-      // Image to use as a thumbnail for the tutorial
-      featuredImage: image().optional(),
-      featuredImageAlt: z.string().optional(),
-      relatedContent: relatedContent().optional(),
-    }),
+    z
+      .object({
+        // Title of the tutorial
+        title: z.string(),
+        // People who wrote the tutorial
+        authors: z.array(z.string()).optional(),
+        // Optional note explaining more context about the authors
+        authorsNote: z.string().optional(),
+        description: z.string().optional(),
+        category: z.enum(categories),
+        categoryIndex: z.number().optional(),
+        // Image to use as a thumbnail for the tutorial
+        featuredImage: image().optional(),
+        featuredImageAlt: z.string().optional(),
+        relatedContent: relatedContent().optional(),
+      })
+      .refine(
+        (data) => {
+          // Allow missing fields during development for quicker iteration
+          if (import.meta.env.DEV) return true;
+          return (
+            data.authors !== undefined &&
+            data.authors.length > 0 &&
+            data.featuredImage !== undefined &&
+            data.featuredImageAlt !== undefined &&
+            data.description !== undefined
+          );
+        },
+        {
+          message:
+            "Tutorials must include authors, featuredImage, featuredImageAlt, and description for production builds",
+        },
+      ),
 });
diff --git a/src/layouts/TutorialLayout.astro b/src/layouts/TutorialLayout.astro
@@ -50,8 +50,8 @@ const relatedExamples =
 <Head
   title={entry.data.title}
   locale={currentLocale}
-  description={entry.data.authors.join(", ")}
-  featuredImageSrc={entry.data.featuredImage.src}
+  description={entry.data.authors?.join(", ")}
+  featuredImageSrc={entry.data.featuredImage?.src}
 />
 
 <BaseLayout
