From 82262de5c2927e802bf09bb5a79545873de532a6 Mon Sep 17 00:00:00 2001
From: Ivan Bochkarev <ivanx86@gmail.com>
Date: Wed, 11 Mar 2026 22:48:16 +0600
Subject: [PATCH 1/3] docs: render minimalVersion badge from layout

- Add minimalVersion to docs collection schemas (docsv3, docsv4, docsv5)
- Render version badge in docs page header when frontmatter has minimalVersion
- Badge shows vX.Y (e.g. v3.12), info color, with aria-label for a11y

Complements nuxt/nuxt#34485: API docs set minimalVersion in frontmatter;
this repo displays the badge so global inline badges are not needed.
---
 app/pages/docs/[...slug].vue | 15 +++++++++++++++
 content.config.ts            |  9 ++++++---
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/app/pages/docs/[...slug].vue b/app/pages/docs/[...slug].vue
index 9209835fd..e033ec091 100644
--- a/app/pages/docs/[...slug].vue
+++ b/app/pages/docs/[...slug].vue
@@ -185,6 +185,21 @@ function refreshHeading(opened: boolean) {
             <UBreadcrumb :items="breadcrumb" />
           </template>
 
+          <template #title>
+            <div class="flex items-center gap-2 flex-wrap">
+              <span>{{ page.title }}</span>
+              <UBadge
+                v-if="page.minimalVersion?.trim()"
+                :label="`v${page.minimalVersion}`"
+                color="info"
+                variant="subtle"
+                size="xs"
+                class="align-middle"
+                :aria-label="`Minimum Nuxt version: v${page.minimalVersion}`"
+              />
+            </div>
+          </template>
+
           <template #links>
             <UButton
               v-for="link in page.links?.map(link => ({ ...link, size: 'md' }))"
diff --git a/content.config.ts b/content.config.ts
index 2240c86d5..edd787bfd 100644
--- a/content.config.ts
+++ b/content.config.ts
@@ -216,7 +216,8 @@ export default defineContentConfig({
       source: [docsV5Source, examplesV5Source],
       schema: z.object({
         titleTemplate: z.string().optional(),
-        links: z.array(Button)
+        links: z.array(Button),
+        minimalVersion: z.string().optional()
       })
     }),
     docsv4: defineCollection({
@@ -224,7 +225,8 @@ export default defineContentConfig({
       source: [docsV4Source, examplesV4Source],
       schema: z.object({
         titleTemplate: z.string().optional(),
-        links: z.array(Button)
+        links: z.array(Button),
+        minimalVersion: z.string().optional()
       })
     }),
     docsv3: defineCollection({
@@ -232,7 +234,8 @@ export default defineContentConfig({
       source: [docsV3Source, examplesV3Source],
       schema: z.object({
         titleTemplate: z.string().optional(),
-        links: z.array(Button)
+        links: z.array(Button),
+        minimalVersion: z.string().optional()
       })
     }),
     blog: defineCollection({

From 92a39e76c4fb8187e759171612ba4568e0eb96d9 Mon Sep 17 00:00:00 2001
From: Ivan Bochkarev <ivanx86@gmail.com>
Date: Wed, 11 Mar 2026 23:07:51 +0600
Subject: [PATCH 2/3] fix(content): accept number or string for minimalVersion
 and normalize to trimmed string

---
 content.config.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/content.config.ts b/content.config.ts
index edd787bfd..97cd06c52 100644
--- a/content.config.ts
+++ b/content.config.ts
@@ -217,7 +217,7 @@ export default defineContentConfig({
       schema: z.object({
         titleTemplate: z.string().optional(),
         links: z.array(Button),
-        minimalVersion: z.string().optional()
+        minimalVersion: z.union([z.string(), z.number()]).optional().transform(v => v === undefined ? undefined : String(v).trim())
       })
     }),
     docsv4: defineCollection({
@@ -226,7 +226,7 @@ export default defineContentConfig({
       schema: z.object({
         titleTemplate: z.string().optional(),
         links: z.array(Button),
-        minimalVersion: z.string().optional()
+        minimalVersion: z.union([z.string(), z.number()]).optional().transform(v => v === undefined ? undefined : String(v).trim())
       })
     }),
     docsv3: defineCollection({
@@ -235,7 +235,7 @@ export default defineContentConfig({
       schema: z.object({
         titleTemplate: z.string().optional(),
         links: z.array(Button),
-        minimalVersion: z.string().optional()
+        minimalVersion: z.union([z.string(), z.number()]).optional().transform(v => v === undefined ? undefined : String(v).trim())
       })
     }),
     blog: defineCollection({

From ad7f23c014ead4b41f376ea5ba92f4ac9992a342 Mon Sep 17 00:00:00 2001
From: Bochkarev Ivan <ivanx86@gmail.com>
Date: Mon, 4 May 2026 21:07:48 +0600
Subject: [PATCH 3/3] Update app/pages/docs/[...slug].vue

Co-authored-by: Benjamin Canac <canacb1@gmail.com>
---
 app/pages/docs/[...slug].vue | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/app/pages/docs/[...slug].vue b/app/pages/docs/[...slug].vue
index ac79426e6..982fe232b 100644
--- a/app/pages/docs/[...slug].vue
+++ b/app/pages/docs/[...slug].vue
@@ -207,18 +207,17 @@ function refreshHeading(opened: boolean) {
           </template>
 
           <template #title>
-            <div class="flex items-center gap-2 flex-wrap">
-              <span>{{ page.title }}</span>
-              <UBadge
-                v-if="page.minimalVersion?.trim()"
-                :label="`v${page.minimalVersion}`"
-                color="info"
-                variant="subtle"
-                size="xs"
-                class="align-middle"
-                :aria-label="`Minimum Nuxt version: v${page.minimalVersion}`"
-              />
-            </div>
+            {{ page.title }}
+
+            <UBadge
+              v-if="page.minimalVersion?.trim()"
+              :label="`v${page.minimalVersion}`"
+              color="info"
+              variant="subtle"
+              size="lg"
+              class="align-middle"
+              :aria-label="`Minimum Nuxt version: v${page.minimalVersion}`"
+            />
           </template>
 
           <template #links>