ci: add devportal publishing workflow

.github/actions/build-docs/action.yml

@@ -16,16 +16,16 @@ runs:
 
     - uses: pnpm/action-setup@v4
       with:
-        version: 10
+        package_json_file: docs/package.json
 
     - name: Install docs dependencies
       shell: bash
-      run: cd docs && pnpm install --frozen-lockfile
+      run: pnpm install --frozen-lockfile --dir docs
 
     - name: Generate CLI reference
       shell: bash
       run: uv run poe docs-cli
 
     - name: Build Starlight site
       shell: bash
-      run: cd docs && pnpm run build
+      run: pnpm --dir docs build

.github/workflows/publish-devportal-docs.yml

@@ -0,0 +1,37 @@
+name: Publish DevPortal Docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    tags: ['v*']
+
+permissions:
+  contents: write
+
+jobs:
+  publish-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+        with:
+          node-version: 24.x
+
+      - uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6
+        with:
+          package_json_file: docs/package.json
+
+      - name: Setup Python environment
+        uses: algorandfoundation/algokit-shared-config/.github/actions/setup-algokit-python@main
+        with:
+          install-algokit: "false"
+
+      - name: Generate CLI reference
+        run: uv run poe docs-cli
+
+      - name: Publish DevPortal Docs
+        uses: algorandfoundation/devportal/.github/actions/publish-devportal-docs@release/ak-v4
+        with:
+          docs-dir: docs

docs/astro.config.mjs

@@ -1,7 +1,9 @@
 // @ts-check
 import starlight from "@astrojs/starlight";
 import { defineConfig } from "astro/config";
+import mermaid from "astro-mermaid";
 import remarkGithubAlerts from "remark-github-alerts";
+import sidebar from "./sidebar.config.json";
 
 export default defineConfig({
   site: "https://algorandfoundation.github.io",
@@ -11,6 +13,7 @@ export default defineConfig({
     remarkPlugins: [remarkGithubAlerts],
   },
   integrations: [
+    mermaid({ theme: "default", autoTheme: true }),
     starlight({
       title: "AlgoKit CLI",
       tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 4 },
@@ -32,76 +35,7 @@ export default defineConfig({
           href: "https://discord.gg/algorand",
         },
       ],
-      sidebar: [
-        { label: "Home", link: "/" },
-        {
-          label: "Getting Started",
-          items: [
-            { slug: "tutorials/intro" },
-            { slug: "tutorials/smart-contracts" },
-            { slug: "tutorials/algokit-template" },
-          ],
-        },
-        {
-          label: "Features",
-          items: [
-            { slug: "features/overview" },
-            { slug: "features/init" },
-            { slug: "features/localnet" },
-            { slug: "features/compile" },
-            { slug: "features/generate" },
-            { slug: "features/config" },
-            { slug: "features/doctor" },
-            { slug: "features/explore" },
-            { slug: "features/dispenser" },
-            { slug: "features/goal" },
-            { slug: "features/completions" },
-            {
-              label: "AlgoKit Project",
-              collapsed: true,
-              items: [
-                { slug: "features/project" },
-                { slug: "features/project/bootstrap" },
-                { slug: "features/project/deploy" },
-                { slug: "features/project/link" },
-                { slug: "features/project/list" },
-                { slug: "features/project/run" },
-              ],
-            },
-            {
-              label: "AlgoKit Task",
-              collapsed: true,
-              items: [
-                { slug: "features/tasks" },
-                { slug: "features/tasks/analyze" },
-                { slug: "features/tasks/ipfs" },
-                { slug: "features/tasks/mint" },
-                { slug: "features/tasks/nfd" },
-                { slug: "features/tasks/opt" },
-                { slug: "features/tasks/send" },
-                { slug: "features/tasks/sign" },
-                { slug: "features/tasks/transfer" },
-                { slug: "features/tasks/vanity_address" },
-                { slug: "features/tasks/wallet" },
-              ],
-            },
-          ],
-        },
-        {
-          label: "Concepts",
-          items: [{ slug: "concepts/output-stability" }],
-        },
-        {
-          label: "Architecture Decisions",
-          collapsed: true,
-          autogenerate: { directory: "architecture-decisions" },
-        },
-        {
-          label: "CLI Reference",
-          collapsed: true,
-          items: [{ slug: "cli", label: "AlgoKit CLI" }],
-        },
-      ],
+      sidebar,
     }),
   ],
 });