fix: defineOgImage v6 API and prerender docs for static hosting

Replace deprecated defineOgImageComponent with defineOgImage.

Enable prerendering for /docs/** so crawlers and OG validators receive
full HTML; seed /docs/getting-started, ignore /_ipx, and allow prerender
to continue when optional nav paths 404.

Made-with: Cursor

Author: OskarLebuda

app/pages/_blog/[...slug].vue

@@ -15,7 +15,7 @@ if (!page.value) {
 // if (page.value.image) {
 //   defineOgImage({ url: page.value.image })
 // } else {
-//   defineOgImageComponent('Docs', {
+//   defineOgImage('Docs', {
 //     headline: breadcrumb.value.map(item => item.label).join(' > ')
 //   }, {
 //     fonts: ['Geist:400', 'Geist:600']

app/pages/changelog.vue

@@ -22,7 +22,7 @@ useSeoMeta({
   ogDescription: description,
 });
 
-defineOgImageComponent('DocsBrowser', {
+defineOgImage('DocsBrowser', {
   headline: 'Vercube',
   title: 'Changelog',
   description: 'Track our journey with a detailed history of updates, improvements, and new features.',

app/pages/docs/[...slug].vue

@@ -35,7 +35,7 @@ const breadcrumb: ComputedRef<BreadcrumbLink[]> = computed(() =>
   })),
 );
 
-defineOgImageComponent(
+defineOgImage(
   'DocsBrowser',
   {
     headline: breadcrumb.value.map((item: BreadcrumbLink) => item.label).join(' > '),
@@ -57,7 +57,7 @@ useSeoMeta({
   ogTitle: titleTemplate.value?.includes('%s') ? titleTemplate.value.replace('%s', title) : title,
 });
 
-defineOgImageComponent(
+defineOgImage(
   'DocsBrowser',
   {
     headline: breadcrumb.value.length ? breadcrumb.value.map((link: BreadcrumbLink) => link.label).join(' > ') : '',

app/pages/index.vue

@@ -35,7 +35,7 @@ const siteUrl = site.url || 'https://vercube.dev';
 const canonicalUrl = `${siteUrl}${route.path}`;
 
 // Define OG Image component for homepage
-defineOgImageComponent(
+defineOgImage(
   'DocsBrowser',
   {
     headline: 'Next generation server framework',

nuxt.config.ts

@@ -45,8 +45,10 @@ export default defineNuxtConfig({
   routeRules: {
     '/': { prerender: true },
     '/docs': { redirect: { statusCode: 301, to: '/docs/getting-started' } },
-    '/docs/**': { prerender: false },
-    // Always SSR: prerender crawl would freeze GitHub releases at build time.
+    // Static hosting (GitHub Pages): docs must be prerendered so crawlers and OG validators get real
+    // HTML with meta tags. Client-only shells look “empty” to bots.
+    '/docs/**': { prerender: true },
+    // Fresh GitHub releases: keep SSR-only (no frozen HTML at build).
     '/changelog': { prerender: false },
     // nuxt-og-image browser renderer needs a real browser at build time; generate at runtime instead.
     '/_og/**': { prerender: false },
@@ -58,9 +60,14 @@ export default defineNuxtConfig({
 
   nitro: {
     prerender: {
-      routes: ['/'],
+      // Seed docs so the crawler can follow sidebar/nav links to every page.
+      routes: ['/', '/docs/getting-started'],
       crawlLinks: true,
       autoSubfolderIndex: false,
+      // Nav includes parent paths without a markdown file (e.g. /docs/modules); crawlers still 404 those.
+      failOnError: false,
+      // IPX URLs are not static files; skip prerendering them (images use `none` provider on GitHub Pages).
+      ignore: ['/_ipx'],
     },
   },