feat: Bruno Collection & API Docs

- Added Bruno Collection
- Added automation script

Author: varungujjar

.gitignore

@@ -1,68 +1,141 @@
+import fs from "node:fs";
+import path from "node:path";
 import { defineConfig } from "vitepress";
 
+function getApiPages() {
+  const apiDir = path.resolve("./api");
+
+  if (!fs.existsSync(apiDir)) {
+    return [];
+  }
+
+  return fs
+    .readdirSync(apiDir, { withFileTypes: true })
+    .filter(
+      (entry) =>
+        entry.isFile() &&
+        entry.name.endsWith(".md")
+    )
+    .map((entry) => {
+      const name = entry.name.replace(
+        /\.md$/,
+        ""
+      );
+
+      return {
+        text:
+          name.charAt(0).toUpperCase() +
+          name.slice(1),
+
+        link: `/api/${name}`,
+      };
+    })
+    .sort((a, b) =>
+      a.text.localeCompare(b.text)
+    );
+}
+
 export default defineConfig({
   title: "Berryaudio",
   description: "Installation, getting started & development docs",
+
   themeConfig: {
     nav: [
       { text: "Home", link: "/" },
-      { text: "Getting Started", link: "/getting-started/introduction" },
-      { text: "Development", link: "/development/architecture" },
-      { text: "Community", link: "https://community.berryaudio.org" },
+      {
+        text: "Getting Started",
+        link: "/getting-started/introduction",
+      },
+      {
+        text: "Development",
+        link: "/development/architecture",
+      },
+      {
+        text: "Community",
+        link: "https://community.berryaudio.org",
+      },
     ],
 
     sidebar: [
       {
         text: "Getting started",
         items: [
-          { text: "Introduction", link: "/getting-started/introduction" },
-          { text: "Installation & Setup", link: "/getting-started/installation" },
-          { text: "Supported Hardware", link: "/getting-started/supported-hardware" },
+          {
+            text: "Introduction",
+            link: "/getting-started/introduction",
+          },
+          {
+            text: "Installation & Setup",
+            link: "/getting-started/installation",
+          },
+          {
+            text: "Supported Hardware",
+            link: "/getting-started/supported-hardware",
+          },
         ],
       },
 
       {
         text: "Development",
         items: [
-          { text: "Architecture", link: "/development/architecture" },
-          { text: "Environment", link: "/development/environment" },
-          { text: "Extensions", link: "/development/extensions" },
+          {
+            text: "Architecture",
+            link: "/development/architecture",
+          },
+          {
+            text: "Environment",
+            link: "/development/environment",
+          },
+          {
+            text: "Extensions",
+            link: "/development/extensions",
+          },
         ],
       },
+
       {
         text: "Display",
         items: [
-          { text: "Generic HDMI", link: "/display/generic-hdmi" },
-          { text: "SSD1322 OLED (256×64)", link: "/display/ssd1322-oled" },
-          { text: "SSD1306 OLED (128×64)", link: "/display/ssd1306-oled" },
-          { text: 'Waveshare 2.8" DSI LCD (480×640)', link: "/display/waveshare-28-dsi-lcd" },
+          {
+            text: "Generic HDMI",
+            link: "/display/generic-hdmi",
+          },
+          {
+            text: "SSD1322 OLED (256×64)",
+            link: "/display/ssd1322-oled",
+          },
+          {
+            text: "SSD1306 OLED (128×64)",
+            link: "/display/ssd1306-oled",
+          },
+          {
+            text: 'Waveshare 2.8" DSI LCD (480×640)',
+            link: "/display/waveshare-28-dsi-lcd",
+          },
         ],
       },
 
       {
-        text: "Extensions",
-        items: [
-          { text: "Bluetooth", link: "/extensions/bluetooth" },
-          { text: "Mixer", link: "/extensions/mixer" },
-          { text: "Playback", link: "/extensions/playback" },
-          { text: "System", link: "/extensions/system" },
-          { text: "Spotify", link: "/extensions/spotify" },
-          { text: "Airplay", link: "/extensions/airplay" },
-          { text: "Snapcast", link: "/extensions/snapcast" },
-          { text: "Radio", link: "/extensions/radio" },
-          { text: "Network", link: "/extensions/network" },
-          { text: "Tracklist", link: "/extensions/tracklist" },
-          { text: "Library", link: "/extensions/library" },
-          { text: "Storage", link: "/extensions/storage" },
-        ],
+        text: "API",
+        items: getApiPages(),
       },
 
       {
         text: "Community",
-        items: [{ text: "Forums", link: "https://www.berryaudio.org" }],
+        items: [
+          {
+            text: "Forums",
+            link: "https://www.berryaudio.org",
+          },
+        ],
       },
     ],
 
-    socialLinks: [{ icon: "github", link: "https://github.com/berry-audio" }],
+    socialLinks: [
+      {
+        icon: "github",
+        link: "https://github.com/berry-audio",
+      },
+    ],
   },
 });

.vitepress/config.mts

@@ -1,15 +1,15 @@
 :root {
   /* Primary brand color */
-  --vp-c-brand-1: #87602a; /* main */
-  --vp-c-brand-2: #6a4b20; /* hover */
-  --vp-c-brand-3: #87602a; /* soft */
+  --vp-c-brand-1: #db462b; /* main */
+  --vp-c-brand-2: #b83a24; /* hover */
+  --vp-c-brand-3: #db462b; /* soft */
 }
 
 /* Optional: dark mode tweaks */
 .dark {
-  --vp-c-brand-1: #87602a;
-  --vp-c-brand-2: #87602a;
-  --vp-c-brand-3: #87602a;
+  --vp-c-brand-1: #db462b;
+  --vp-c-brand-2: #db462b;
+  --vp-c-brand-3: #db462b;
 }
 
 .vp-doc .info strong {
@@ -131,4 +131,14 @@ details[open] .arrow {
   width: 100%;
   height: auto;
   display: block;
+}
+
+.vp-doc table {
+  width: 100%;
+  display: table;
+}
+
+.vp-doc th,
+.vp-doc td {
+  padding: 8px 12px;
 }