Dynamic Docs

.github/workflows/deploy-pages-dev.yml

@@ -35,6 +35,11 @@ jobs:
           cache: npm # or pnpm / yarn
       - name: Setup Pages
         uses: actions/configure-pages@v4
+      - name: Set Version
+        run: |
+          version=$(grep 'version:' firmware/base.yaml | awk -F'"' '{print $2}')
+          version="$version-dev"
+          sed -i "s/\"version\": \"[^\"]*\"/\"version\": \"$version\"/" package.json
       - name: Install dependencies
         run: npm ci
       - name: Build with VitePress
@@ -49,7 +54,7 @@ jobs:
     name: Build Doorman Stock Firmware
     uses: ./.github/workflows/esphome-build.yml
     with:
-      files: firmware/doorman-stock.dev.yaml
+      files: firmware/doorman-stock.yaml
       name: AzonInc.Doorman-Stock
       esphome_version: dev
       directory_name: doorman-stock
@@ -58,7 +63,7 @@ jobs:
     name: Build Doorman Nuki Bridge Firmware
     uses: ./.github/workflows/esphome-build.yml
     with:
-      files: firmware/doorman-nuki-bridge.dev.yaml
+      files: firmware/doorman-nuki-bridge.yaml
       name: AzonInc.Doorman-Nuki-Bridge
       esphome_version: dev
       directory_name: doorman-nuki-bridge

.github/workflows/deploy-pages.yml

@@ -41,6 +41,10 @@ jobs:
           cache: npm # or pnpm / yarn
       - name: Setup Pages
         uses: actions/configure-pages@v4
+      - name: Set Version
+        run: |
+          version=$(grep 'version:' firmware/base.yaml | awk -F'"' '{print $2}')
+          sed -i "s/\"version\": \"[^\"]*\"/\"version\": \"$version\"/" package.json
       - name: Install dependencies
         run: npm ci
       - name: Build with VitePress

docs/.vitepress/config.mts

@@ -1,5 +1,9 @@
+import { createRequire } from 'module'
 import { defineConfig } from 'vitepress'
 
+const require = createRequire(import.meta.url)
+const pkg = require('../../package.json')
+
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
   title: "Doorman",
@@ -39,7 +43,17 @@ export default defineConfig({
     // https://vitepress.dev/reference/default-theme-config
     nav: [
       { text: 'Guide', link: '/guide/what-is-doorman' },
-      { text: 'Creators', link: '/creators' }
+      { text: 'Creators', link: '/creators' },
+      {
+        text: pkg.version,
+        items: [
+          {
+            text: !pkg.version.includes('dev') ? 'Switch to Development Docs' : 'Switch to Stable Docs',
+            link: !pkg.version.includes('dev') ? 'https://doorman-dev.surge.sh/' : 'https://doorman.azon.ai/',
+            target: '_self'
+          }
+        ]
+      }
     ],
 
     editLink: {

docs/firmware/nuki-bridge-firmware.md

@@ -10,7 +10,7 @@ There are a few ways to update the firmware:
 - Web Serial <Badge type="tip" text="Latest release build, no customization" />
 
 You can connect your Doorman via USB-C and click the button below to install the latest and greatest Doorman Nuki Bridge Firmware right here via Web Serial.
-<esp-web-install-button manifest="https://doorman.azon.ai/firmware/release/doorman-nuki-bridge/manifest.json">
+<esp-web-install-button manifest="./release/doorman-nuki-bridge/manifest.json">
     <button slot="activate">
         <div class="custom-layout">
             <a class="btn">Install or Update Firmware</a>

docs/firmware/stock-firmware.md

@@ -10,7 +10,7 @@ There are a few ways to update the firmware:
 - Web Serial <Badge type="tip" text="Latest release build, no customization" />
 
 You can connect your Doorman via USB-C and click the button below to install the latest and greatest Doorman Stock Firmware right here via Web Serial.
-<esp-web-install-button manifest="https://doorman.azon.ai/firmware/release/doorman-stock/manifest.json">
+<esp-web-install-button manifest="./release/doorman-stock/manifest.json">
     <button slot="activate">
         <div class="custom-layout">
             <a class="btn">Install or Update Firmware</a>

firmware/base.yaml

@@ -64,7 +64,7 @@ esphome:
 
   project:
     name: "AzonInc.Doorman-Stock"
-    version: "2024.8.1"
+   version: "2024.8.1" 
 
   platformio_options:
     board_build.flash_mode: dio

package.json

@@ -1,5 +1,8 @@
 {
+  "name": "doorman",
+  "version": "2024.8.0",
   "devDependencies": {
+    "@types/node": "^22.3.0",
     "vitepress": "^1.3.2"
   },
   "scripts": {