feat: added docs page

Author: blaquewithaq

app/error.vue

@@ -14,9 +14,11 @@ useHead({
   }
 })
 
+const { data: app } = await useAsyncData('app-error', () => queryCollection('app').first())
+
 useSeoMeta({
-  title: 'Page not found',
-  description: 'We are sorry but this page could not be found.'
+  title: app.value?.error.title || 'Page not found',
+  description: app.value?.error.description || 'We are sorry but this page could not be found.'
 })
 
 const { data: navigation } = await useAsyncData('navigation', () => queryCollectionNavigation('docs'), {
@@ -25,20 +27,6 @@ const { data: navigation } = await useAsyncData('navigation', () => queryCollect
 const { data: files } = useLazyAsyncData('search', () => queryCollectionSearchSections('docs'), {
   server: false
 })
-
-const links = [{
-  label: 'Docs',
-  icon: 'i-lucide-book',
-  to: '/docs/getting-started'
-}, {
-  label: 'Pricing',
-  icon: 'i-lucide-credit-card',
-  to: '/pricing'
-}, {
-  label: 'Blog',
-  icon: 'i-lucide-pencil',
-  to: '/blog'
-}]
 </script>
 
 <template>
@@ -60,7 +48,7 @@ const links = [{
         :files="files"
         shortcut="meta_k"
         :navigation="navigation"
-        :links="links"
+        :links="app?.links"
         :fuse="{ resultLimit: 42 }"
       />
     </ClientOnly>

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

@@ -1,9 +1,57 @@
 <script setup lang="ts">
+definePageMeta({
+  layout: 'docs'
+})
 
+const route = useRoute()
+
+const { data: page } = await useAsyncData(route.path, () => queryCollection('docs').path(route.path).first())
+if (!page.value) {
+  throw createError({ statusCode: 404, statusMessage: 'Page not found', fatal: true })
+}
+
+const { data: surround } = await useAsyncData(`${route.path}-surround`, () => {
+  return queryCollectionItemSurroundings('docs', route.path, {
+    fields: ['description']
+  })
+})
+
+const title = page.value.seo?.title || page.value.title
+const description = page.value.seo?.description || page.value.description
+
+useSeoMeta({
+  title,
+  ogTitle: title,
+  description,
+  ogDescription: description
+})
+
+defineOgImageComponent('Saas')
 </script>
 
 <template>
-  <div>
-    <!--  -->
-  </div>
+  <UPage v-if="page">
+    <UPageHeader
+      :title="page.title"
+      :description="page.description"
+    />
+
+    <UPageBody>
+      <ContentRenderer
+        v-if="page.body"
+        :value="page"
+      />
+
+      <USeparator v-if="surround?.length" />
+
+      <UContentSurround :surround="surround" />
+    </UPageBody>
+
+    <template
+      v-if="page?.body?.toc?.links?.length"
+      #right
+    >
+      <UContentToc :links="page.body.toc.links" />
+    </template>
+  </UPage>
 </template>

bun.lock

@@ -70,6 +70,7 @@ const collections = {
     source: 'app.yml',
     schema: z.object({
       links: z.array(createLinkSchema()).optional(),
+      error: createBaseSchema(),
       header: z.object({
         logo: z.object({
           to: z.string()

content.config.ts

@@ -0,0 +1 @@
+title: User

content/1.docs/1.getting-started/.navigation.yml

@@ -0,0 +1 @@
+title: Developer

content/1.docs/1.user/.navigation.yml

@@ -0,0 +1,5 @@
+---
+title: Introduction
+description: Welcome to our Developer Guide
+---
+

content/1.docs/1.getting-started/1.index.md renamed to content/1.docs/1.user/1.index.md

@@ -0,0 +1,4 @@
+---
+title: Installation
+description: Get started with the installation of our software.
+---

content/1.docs/1.getting-started/2.installation.md renamed to content/1.docs/1.user/2.installation.md

@@ -3,12 +3,12 @@ links:
     icon: i-lucide-book
     to: /docs
     children:
-      - label: User Guide
+      - label: User
         icon: i-lucide-book-text
         description: Get started with our user-friendly guide.
         to: /docs/user
         disabled: false
-      - label: Developer Guide
+      - label: Developer
         icon: i-lucide-code-xml
         description: Dive into our developer documentation.
         to: /docs/developer
@@ -30,6 +30,9 @@ links:
     icon: i-simple-icons-github
     to: https://github.com/projectm-visualizer
     target: '_blank'
+error:
+  title: Page not found
+  description: We are sorry but this page could not be found.
 header:
   logo:
       to: /
@@ -69,4 +72,3 @@ footer:
         icon: i-simple-icons-github
         to: https://github.com/projectm-visualizer
         target: _blank
-

content/1.docs/2.developer/.navigation.yml

@@ -31,7 +31,7 @@ export default defineNuxtConfig({
   },
 
   routeRules: {
-    '/docs': { redirect: '/docs/getting-started', prerender: false }
+    '/docs': { redirect: '/docs/user', prerender: false }
   },
 
   future: {