InfiniLore · AnnaSasDev · Apr 10, 2026 · Apr 9, 2026 · Apr 9, 2026 · Apr 9, 2026
diff --git a/.github/workflows/shared-release-publish-docs.yml b/.github/workflows/shared-release-publish-docs.yml
@@ -20,55 +20,38 @@ concurrency:
 jobs:           
     build:
         name: Build Docs
-        runs-on: windows-latest
+        runs-on: ubuntu-latest
 
         steps:
             -   name: Checkout
                 uses: actions/checkout@v6
                 with:
                     ref: ${{ inputs.checkout_ref != '' && inputs.checkout_ref || github.ref }}
 
-            -   name: Setup .NET
-                uses: actions/setup-dotnet@v5
+            -   name: Setup Node
+                uses: actions/setup-node@v6
                 with:
-                    dotnet-version: |
-                        8.x
-                        9.x
-                        10.x
-
-            -   name: Install DocFX
-                shell: pwsh
-                run: |
-                    dotnet tool install --global docfx --version 2.78.5
-                    "$env:USERPROFILE\.dotnet\tools" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
-
-            -   name: Install Doxygen
-                shell: pwsh
-                run: choco install doxygen.install -y --no-progress
-
-            -   name: Generate API Metadata
-                run: docfx metadata docs/docfx.json
+                    node-version: 20
+                    cache: npm
+                    cache-dependency-path: |
+                        package-lock.json
+                        docs/package-lock.json
 
-            -   name: Generate C++ Docs
-                shell: pwsh
-                run: ./docs/scripts/update-cpp-api.ps1 -Required
+            -   name: Install Docusaurus Dependencies
+                shell: bash
+                run: npm ci --prefix docs
 
-            -   name: Build Docs Site
-                shell: pwsh
-                run: |
-                    $logPath = Join-Path $env:RUNNER_TEMP "docfx-build.log"
-                    docfx build docs/docfx.json 2>&1 | Tee-Object -FilePath $logPath
-                    if (Select-String -Path $logPath -Pattern '^\s*[1-9][0-9]* warning\(s\)' -Quiet) {
-                        throw "DocFX reported warnings."
-                    }
+            -   name: Build Docusaurus Site
+                shell: bash
+                run: npm run docs:build
 
             -   name: Setup Pages
                 uses: actions/configure-pages@v6
 
             -   name: Upload Pages Artifact
                 uses: actions/upload-pages-artifact@v4
                 with:
-                    path: docs/_site
+                    path: docs/build
 
     deploy:
         name: Deploy Docs

diff --git a/.github/workflows/shared-testing-docs.yml b/.github/workflows/shared-testing-docs.yml
@@ -31,52 +31,18 @@ jobs:
                 with:
                     ref: ${{ inputs.checkout_ref != '' && inputs.checkout_ref || env.TARGET_SHA }}
 
-            -   name: Setup .NET
-                uses: actions/setup-dotnet@v5
-                with:
-                    dotnet-version: |
-                        8.x
-                        9.x
-                        10.x
-
             -   name: Setup Node
                 uses: actions/setup-node@v6
                 with:
-                    node-version: 24
-
-            -   name: Cache .NET Tools & NuGet
-                uses: actions/cache@v5
-                with:
-                    path: |
-                        ~/.nuget/packages
-                        ~/.dotnet/tools
-                    key: dotnet-tools-${{ runner.os }}-docfx-2.78.5
-                    restore-keys: |
-                        dotnet-tools-${{ runner.os }}-docfx-
-
-            -   name: Add Tools Path
-                run: echo "$HOME/.dotnet/tools" >> $GITHUB_PATH
-
-            -   name: Install DocFX if needed
-                run: |
-                    set -euo pipefail
-                    REQUIRED_VERSION=2.78.5
-
-                    INSTALLED_VERSION=$(dotnet tool list --global | awk '$1=="docfx"{print $2}')
-                    if [ "$INSTALLED_VERSION" = "$REQUIRED_VERSION" ]; then
-                        echo "DocFX $REQUIRED_VERSION already installed, skipping install."
-                    elif [ -n "$INSTALLED_VERSION" ]; then
-                        echo "DocFX version mismatch ($INSTALLED_VERSION), reinstalling..."
-                        dotnet tool update --global docfx --version $REQUIRED_VERSION
-                    else
-                        echo "DocFX not found, installing..."
-                        dotnet tool install --global docfx --version $REQUIRED_VERSION
-                    fi
+                    node-version: 20
+                    cache: npm
+                    cache-dependency-path: |
+                        package-lock.json
+                        docs/package-lock.json
 
-            -   name: Install Deps
-                uses: awalsh128/cache-apt-pkgs-action@v1
-                with:
-                    packages: doxygen
+            -   name: Install Docusaurus Dependencies
+                shell: bash
+                run: npm ci --prefix docs
 
             -   name: Set Docs Pending
                 env:
@@ -93,22 +59,9 @@ jobs:
                     target-url: ${{ format('{0}/{1}/actions/runs/{2}', github.server_url, github.repository, github.run_id) }}
                     allow-status-422: 'true'
 
-            -   name: Generate API Metadata
-                run: docfx metadata docs/docfx.json
-
-            -   name: Generate C++ Docs
-                shell: pwsh
-                run: ./docs/scripts/update-cpp-api.ps1 -Required
-
-            -   name: Build Docs
+            -   name: Build Docusaurus Docs
                 shell: bash
-                run: |
-                    set -euo pipefail
-
-                    docfx build docs/docfx.json 2>&1 | tee /tmp/docfx-build.log
-                    if grep -Eq '^[[:space:]]*[1-9][0-9]* warning\(s\)' /tmp/docfx-build.log; then
-                      exit 1
-                    fi
+                run: npm run docs:build
 
             -   name: Complete Docs Check
                 if: always()
@@ -124,4 +77,4 @@ jobs:
                     target-url: ${{ format('{0}/{1}/actions/runs/{2}', github.server_url, github.repository, github.run_id) }}
                     job-status: ${{ job.status }}
                     success-description: Docs validation finished successfully
-                    failure-description: Docs validation failed due to warnings or errors
+                    failure-description: Docs validation failed
diff --git a/.gitignore b/.gitignore
@@ -354,11 +354,3 @@ healthchecksdb
 /examples/InfiniFrameExample.WebApp.Vue/wwwroot/
 /tests/InfiniFrameTests.Playwright/wwwroot/
 
-# DocFX generated outputs
-/docs/_site/
-/docs/api/*.yml
-/docs/api/toc.yml
-/docs/api/.manifest
-/docs/api/cs/
-/docs/api/cpp/native-cpp-reference.md
-/docs/.doxygen/
diff --git a/README.md b/README.md
@@ -135,44 +135,47 @@ dotnet tool run infiniframe-pack publish src/MyApp/MyApp.csproj --rid win-x64
 ## Documentation
 
 - [Docs Home](https://docs.infiniframe.dev/)
-- [Getting Started](https://docs.infiniframe.dev/articles/guides/getting-started.html) — Installation, first app,
+- [Getting Started](https://docs.infiniframe.dev/guides/getting-started) — Installation, first app,
   platform requirements
 
 ### Guides
 
-- [Core Window](https://docs.infiniframe.dev/articles/guides/core-window.html) — Builder pattern, configuration, events,
+- [Core Window](https://docs.infiniframe.dev/guides/core-window) — Builder pattern, configuration, events,
   messaging
-- [Blazor WebView](https://docs.infiniframe.dev/articles/guides/blazor-webview.html) — Hosting a full Blazor app in a
+- [Blazor WebView](https://docs.infiniframe.dev/guides/blazor-webview) — Hosting a full Blazor app in a
   native window
-- [Web Server](https://docs.infiniframe.dev/articles/guides/web-server.html) — ASP.NET Core + native window integration
-- [Custom Window Chrome](https://docs.infiniframe.dev/articles/guides/custom-window-chrome.html) — Chromeless windows
+- [Web Server](https://docs.infiniframe.dev/guides/web-server) — ASP.NET Core + native window integration
+- [Custom Window Chrome](https://docs.infiniframe.dev/guides/custom-window-chrome) — Chromeless windows
   with Blazor components
-- [JavaScript Interop](https://docs.infiniframe.dev/articles/guides/javascript-interop.html) — Communicating between JS
+- [JavaScript Interop](https://docs.infiniframe.dev/guides/javascript-interop) — Communicating between JS
   and C#
 
 ### API Reference
 
-- [Native C++ API Guide](https://docs.infiniframe.dev/articles/cpp/native-cpp-api.html)
-- [Native C++ API Reference (Generated)](https://docs.infiniframe.dev/api/cpp/native-cpp-reference.html)
-- [Generated C# API Reference](https://docs.infiniframe.dev/api/cs/)
+- [Native C++ API Guide](https://docs.infiniframe.dev/cpp/native-cpp-api)
+- [API Reference Hub](https://docs.infiniframe.dev/api)
 
 ### Migration
 
-- [Breaking Changes vs Photino.NET](https://docs.infiniframe.dev/articles/concepts/breaking-changes-from-photino.html) —
+- [Breaking Changes vs Photino.NET](https://docs.infiniframe.dev/migration/breaking-changes-from-photino) —
   API, namespace, event system, and behavioral differences from the original Photino projects
 
 ### Build Docs Locally
 
 Requirements:
 
-- `docfx` (required)
-- `Doxygen` (required for generated C++ API reference)
-- `Node.js`/`npm` (required for `npx moxygen` during C++ API reference generation)
+- `Node.js`/`npm` (required)
 
 Run:
 
 ```powershell
-.\docs\scripts\serve-docs.ps1
+npm run docs:dev
+```
+
+Build static site:
+
+```powershell
+npm run docs:build
 ```
 
 ## Platform Requirements

diff --git a/assets/icon.png b/assets/icon.png
diff --git a/docs/.gitignore b/docs/.gitignore
@@ -0,0 +1,3 @@
+.docusaurus
+build
+node_modules
diff --git a/docs/api/cpp/toc.yml b/docs/api/cpp/toc.yml
diff --git a/docs/articles/concepts/toc.yml b/docs/articles/concepts/toc.yml
diff --git a/docs/articles/cpp/toc.yml b/docs/articles/cpp/toc.yml
diff --git a/docs/articles/csharp/toc.yml b/docs/articles/csharp/toc.yml
diff --git a/docs/articles/guides/toc.yml b/docs/articles/guides/toc.yml
diff --git a/docs/docfx.json b/docs/docfx.json
diff --git a/docs/docs/api.md b/docs/docs/api.md
@@ -0,0 +1,16 @@
+---
+id: api
+slug: /api
+title: API Reference
+---
+
+InfiniFrame API documentation is currently maintained inline in Docusaurus.
+
+- Managed API guidance:
+  - [Core Window Guide](guides/core-window.md)
+  - [Blazor WebView Guide](guides/blazor-webview.md)
+  - [Web Server Guide](guides/web-server.md)
+- Native API guidance:
+  - [Native C++ API Guide](cpp/native-cpp-api.md)
+
+This keeps the API docs simple and versionless by design.
diff --git a/docs/articles/cpp/code-style.md → docs/docs/cpp/code-style.md b/docs/articles/cpp/code-style.md → docs/docs/cpp/code-style.md
diff --git a/docs/articles/cpp/native-cpp-api.md → docs/docs/cpp/native-cpp-api.md b/docs/articles/cpp/native-cpp-api.md → docs/docs/cpp/native-cpp-api.md
@@ -1,6 +1,6 @@
 # Native C++ API
 
-InfiniFrame native API documentation is hosted inside DocFX as conceptual reference and is sourced from the native headers and Doxygen-style comments under `src/InfiniFrame.Native`.
+InfiniFrame native API documentation is maintained directly in Docusaurus and sourced from the native headers and comments under `src/InfiniFrame.Native`.
 
 ## Core headers
 
@@ -27,6 +27,4 @@ InfiniFrame native API documentation is hosted inside DocFX as conceptual refere
 
 - `Exports.cpp`: exported C ABI used by the managed layer.
 
-For detailed behavior, see source comments in the files above. This page is maintained in DocFX to keep C++ documentation and C# documentation in one navigation model.
-
-For generated member-level C++ reference, see [Native C++ API Reference (Generated)](../../api/cpp/native-cpp-reference.md).
+For detailed behavior, see source comments in the files above.
diff --git a/docs/articles/csharp/code-style.md → docs/docs/csharp/code-style.md b/docs/articles/csharp/code-style.md → docs/docs/csharp/code-style.md
diff --git a/docs/articles/guides/blazor-webview.md → docs/docs/guides/blazor-webview.md b/docs/articles/guides/blazor-webview.md → docs/docs/guides/blazor-webview.md
diff --git a/docs/articles/guides/core-window.md → docs/docs/guides/core-window.md b/docs/articles/guides/core-window.md → docs/docs/guides/core-window.md
diff --git a/docs/articles/guides/custom-window-chrome.md → docs/docs/guides/custom-window-chrome.md b/docs/articles/guides/custom-window-chrome.md → docs/docs/guides/custom-window-chrome.md
diff --git a/docs/articles/guides/getting-started.md → docs/docs/guides/getting-started.md b/docs/articles/guides/getting-started.md → docs/docs/guides/getting-started.md
@@ -187,4 +187,4 @@ The start URL is automatically read from `ASPNETCORE_URLS` or the `urls` configu
 - [Core Window Guide](core-window.md) — Window events, messaging, dialogs, custom schemes
 - [Blazor Guide](blazor-webview.md) — DI, file providers, component configuration
 - [Web Server Guide](web-server.md) — ASP.NET Core pipeline, DI access, graceful shutdown
-- Generated C# API Reference (`docs/api`, via `docfx metadata`) — Complete member-level reference
+- [API Reference](../api.md) — Central API navigation and language-specific guides
diff --git a/docs/articles/guides/javascript-interop.md → docs/docs/guides/javascript-interop.md b/docs/articles/guides/javascript-interop.md → docs/docs/guides/javascript-interop.md
diff --git a/docs/articles/guides/pack-tool.md → docs/docs/guides/pack-tool.md b/docs/articles/guides/pack-tool.md → docs/docs/guides/pack-tool.md
diff --git a/docs/articles/guides/web-server.md → docs/docs/guides/web-server.md b/docs/articles/guides/web-server.md → docs/docs/guides/web-server.md
diff --git a/docs/docs/intro.md b/docs/docs/intro.md
@@ -0,0 +1,14 @@
+---
+id: intro
+slug: /
+title: InfiniFrame Documentation
+---
+
+InfiniFrame documentation is organized into Guides, Concepts, and API references for both managed and native layers.
+
+## Sections
+
+- [Guides](guides/getting-started.md)
+- [Packaging Tool Guide](guides/pack-tool.md)
+- [Migration Notes](migration/breaking-changes-from-photino.md)
+- [API References](api.md)
diff --git a/...concepts/breaking-changes-from-photino.md → ...igration/breaking-changes-from-photino.md b/...concepts/breaking-changes-from-photino.md → ...igration/breaking-changes-from-photino.md