Update Docs

Author: AzonInc

docs/.vitepress/config.mts

@@ -1,5 +1,5 @@
 import { createRequire } from 'module'
-import { defineConfig } from 'vitepress'
+import { defineConfig, type DefaultTheme } from 'vitepress'
 
 const require = createRequire(import.meta.url)
 const pkg = require('../../package.json')
@@ -27,6 +27,14 @@ export default defineConfig({
         type: 'module',
         src: 'https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module'
       }
+    ],
+    [
+      'script',
+      {
+        async: '',
+        type: 'module',
+        src: 'https://kicanvas.org/kicanvas/kicanvas.js'
+      }
     ]
   ],
 
@@ -42,8 +50,16 @@ export default defineConfig({
 
     // https://vitepress.dev/reference/default-theme-config
     nav: [
-      { text: 'Guide', link: '/guide/what-is-doorman' },
-      { text: 'Creators', link: '/creators' },
+      {
+        text: 'Guide',
+        link: '/guide/what-is-doorman',
+        activeMatch: '/guide/'
+      },
+      {
+        text: 'Reference',
+        link: '/reference/entities',
+        activeMatch: '/reference/'
+      },
       {
         text: pkg.version,
         items: [
@@ -64,56 +80,76 @@ export default defineConfig({
       provider: 'local'
     },
 
-    sidebar: [
-      {
-        text: 'Introduction',
-        items: [
-          { text: 'What is Doorman?', link: '/guide/what-is-doorman' },
-          { text: 'Getting Started', link: '/guide/getting-started' },
-        ]
-      },
-      {
-        text: 'Compatibility',
-        items: [
-          { text: 'Can I use Doorman?', link: '/compatibility/hardware-compatibility' },
-          { text: 'Doorman PCB', link: '/compatibility/specifications' }
-        ]
-      },
-      {
-        text: 'Firmware',
-        items: [
-          { text: 'Stock Firmware', link: '/firmware/stock-firmware' },
-          { text: 'Nuki Bridge Firmware', link: '/firmware/nuki-bridge-firmware' },
-          { text: 'Custom Firmware', link: '/firmware/custom-firmware' }
-        ]
-      },
-      {
-        text: 'Automations',
-        items: [
-          { text: 'Pattern Events', link: '/automation/pattern-events' },
-          { text: 'Ring To Open', link: '/automation/ring-to-open' },
-          { text: 'Blueprints', link: '/automation/blueprints' }
-        ]
-      },
-      {
-        text: 'Enclosure',
-        items: [
-          { text: '3D printing', link: '/enclosure/3d-printing' }
-        ]
-      },
-      {
-        text: 'Support',
-        link: '/support/support',
-        collapsed: true,
-        items: [
-          { text: 'Troubleshooting', link: '/support/troubleshooting' }
-        ]
-      }
-    ],
+    sidebar: {
+      '/guide/': { base: '/guide/', items: sidebarGuide() },
+      '/reference/': { base: '/reference/', items: sidebarReference() }
+    },
 
     socialLinks: [
       { icon: 'github', link: 'https://github.com/AzonInc/Doorman' },
       { icon: 'discord', link: 'https://discord.gg/t2d34dvmBf' }
-    ]
+    ],
+
+    footer: {
+      message: 'Released under the GPL 3.0 License.',
+      copyright: 'Made with ❤️ by the <a href="creators">Creators</a> of Doorman.'
+    }
   }
 })
+
+function sidebarGuide(): DefaultTheme.SidebarItem[] {
+  return [
+    {
+      text: 'Introduction',
+      items: [
+        { text: 'What is Doorman?', link: 'what-is-doorman' },
+        { text: 'Getting Started', link: 'getting-started' },
+        { text: 'Can I use Doorman?', link: 'hardware-compatibility' }
+      ]
+    },
+    {
+      text: 'Firmware',
+      items: [
+        { text: 'Stock Firmware', link: 'stock-firmware', base: '/guide/firmware/' },
+        { text: 'Nuki Bridge Firmware', link: 'nuki-bridge-firmware', base: '/guide/firmware/' },
+        { text: 'Custom Firmware', link: 'custom-firmware', base: '/guide/firmware/' }
+      ]
+    },
+    {
+      text: 'Automations',
+      items: [
+        { text: 'Pattern Events', link: 'pattern-events', base: '/guide/automation/' },
+        { text: 'Ring To Open', link: 'ring-to-open', base: '/guide/automation/' },
+        { text: 'Blueprints', link: 'blueprints', base: '/guide/automation/' }
+      ]
+    },
+    {
+      text: 'Enclosure',
+      items: [
+        { text: '3D printing', link: '3d-printing', base: '/guide/enclosure/' }
+      ]
+    },
+    {
+      text: 'Support',
+      link: 'support',
+      base: '/guide/support/',
+      collapsed: true,
+      items: [
+        { text: 'Troubleshooting', link: 'troubleshooting', base: '/guide/support/' },
+      ]
+    }
+  ];
+}
+
+function sidebarReference(): DefaultTheme.SidebarItem[] {
+  return [
+    {
+      text: 'Reference',
+      items: [
+        { text: 'Entities', link: 'entities' },
+        { text: 'GPIO Pinout', link: 'gpio' },
+        { text: 'Schematics', link: 'schematics' }
+      ]
+    }
+  ];
+}