gridstack · adumesny · Aug 10, 2025 · Aug 10, 2025
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
@@ -0,0 +1,96 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [ master ]
+  # Allow manual triggering
+  workflow_dispatch:
+
+jobs:
+  deploy-docs:
+    runs-on: ubuntu-latest
+    # Only run on pushes to master (not PRs)
+    if: github.ref == 'refs/heads/master'
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '18'
+        cache: 'yarn'
+
+    - name: Install main dependencies
+      run: yarn install --frozen-lockfile
+
+    - name: Install Angular dependencies
+      run: |
+        cd angular
+        yarn install --frozen-lockfile
+
+    - name: Build Angular library
+      run: yarn build:ng
+
+    - name: Build main library
+      run: |
+        grunt
+        webpack
+        tsc --stripInternal
+
+    - name: Generate all documentation
+      run: yarn doc:all
+
+    - name: Prepare deployment structure
+      run: |
+        mkdir -p deploy
+
+        # Create proper directory structure for GitHub Pages
+        mkdir -p deploy/docs/html
+        mkdir -p deploy/angular/docs/html
+
+        # Copy main library HTML documentation
+        if [ -d "docs/html" ]; then
+          cp -r docs/html/* deploy/docs/html/
+        fi
+
+        # Copy Angular library HTML documentation  
+        if [ -d "angular/docs/html" ]; then
+          cp -r angular/docs/html/* deploy/angular/docs/html/
+        fi
+
+        # Copy redirect index.html to root
+        if [ -f "docs/index.html" ]; then
+          cp docs/index.html deploy/
+        fi
+
+        # Ensure .nojekyll exists to prevent Jekyll processing
+        touch deploy/.nojekyll
+
+        # Optional: Add a simple index.html at root if none exists
+        if [ ! -f "deploy/index.html" ]; then
+          cat > deploy/index.html << 'EOF'
+        <!DOCTYPE html>
+        <html>
+        <head>
+            <title>GridStack.js Documentation</title>
+            <meta http-equiv="refresh" content="0; url=./docs/html/">
+        </head>
+        <body>
+            <h1>GridStack.js Documentation</h1>
+            <p>Redirecting to <a href="./docs/html/">API Documentation</a>...</p>
+        </body>
+        </html>
+        EOF
+        fi
+
+    - name: Deploy to GitHub Pages
+      uses: peaceiris/actions-gh-pages@v4
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./deploy
+        keep_files: true
+        commit_message: 'Deploy documentation from ${{ github.sha }}'
diff --git a/README.md b/README.md
@@ -59,7 +59,7 @@ Join us on Slack: [https://gridstackjs.slack.com](https://join.slack.com/t/grids
 
 # Demo and API Documentation
 
-Please visit http://gridstackjs.com and [these demos](http://gridstackjs.com/demo/), and complete [API documentation](https://github.com/gridstack/gridstack.js/tree/master/doc)
+Please visit http://gridstackjs.com and [these demos](http://gridstackjs.com/demo/), and complete [API documentation](https://gridstack.github.io/gridstack.js/docs/html/) ([markdown](https://github.com/gridstack/gridstack.js/tree/master/doc))
 
 # Usage
 

diff --git a/angular/typedoc.html.json b/angular/typedoc.html.json
@@ -27,7 +27,7 @@
   "excludePrivate": true,
   "excludeProtected": false,
   "excludeInternal": true,
-  "includeVersion": true,
+  "includeVersion": false,
   "sort": ["source-order"],
   "sortEntryPoints": false,
   "kindSortOrder": [
@@ -73,6 +73,7 @@
     "Angular Guide": "README.md"
   },
   "hostedBaseUrl": "https://gridstack.github.io/gridstack.js/angular/",
+  "githubPages": true,
   "gitRevision": "master",
   "gitRemote": "origin",
   "name": "GridStack Angular Library"

diff --git a/angular/typedoc.json b/angular/typedoc.json
@@ -29,7 +29,7 @@
   "excludePrivate": true,
   "excludeProtected": false,
   "excludeInternal": true,
-  "includeVersion": true,
+  "includeVersion": false,
   "sort": ["source-order"],
   "sortEntryPoints": false,
   "kindSortOrder": [

diff --git a/docs/api/index.md b/docs/api/index.md
@@ -1,4 +1,4 @@
-# gridstack v12.3.0
+# gridstack
 
 ## Classes
 

diff --git a/docs/html/classes/DDBaseImplement.html b/docs/html/classes/DDBaseImplement.html
diff --git a/docs/html/classes/DDDraggable.html b/docs/html/classes/DDDraggable.html
diff --git a/docs/html/classes/DDDroppable.html b/docs/html/classes/DDDroppable.html
diff --git a/docs/html/classes/DDElement.html b/docs/html/classes/DDElement.html
diff --git a/docs/html/classes/DDGridStack.html b/docs/html/classes/DDGridStack.html
diff --git a/docs/html/classes/DDManager.html b/docs/html/classes/DDManager.html
diff --git a/docs/html/classes/DDResizable.html b/docs/html/classes/DDResizable.html
diff --git a/docs/html/classes/DDResizableHandle.html b/docs/html/classes/DDResizableHandle.html
diff --git a/docs/html/classes/GridStack.html b/docs/html/classes/GridStack.html
diff --git a/docs/html/classes/GridStackEngine.html b/docs/html/classes/GridStackEngine.html
diff --git a/docs/html/classes/Utils.html b/docs/html/classes/Utils.html
diff --git a/docs/html/hierarchy.html b/docs/html/hierarchy.html
diff --git a/docs/html/index.html b/docs/html/index.html
diff --git a/docs/html/interfaces/Breakpoint.html b/docs/html/interfaces/Breakpoint.html
diff --git a/docs/html/interfaces/CellPosition.html b/docs/html/interfaces/CellPosition.html
diff --git a/docs/html/interfaces/DDDragOpt.html b/docs/html/interfaces/DDDragOpt.html
diff --git a/docs/html/interfaces/DDDroppableOpt.html b/docs/html/interfaces/DDDroppableOpt.html
diff --git a/docs/html/interfaces/DDElementHost.html b/docs/html/interfaces/DDElementHost.html
diff --git a/docs/html/interfaces/DDRemoveOpt.html b/docs/html/interfaces/DDRemoveOpt.html
diff --git a/docs/html/interfaces/DDResizableHandleOpt.html b/docs/html/interfaces/DDResizableHandleOpt.html
diff --git a/docs/html/interfaces/DDResizableOpt.html b/docs/html/interfaces/DDResizableOpt.html
diff --git a/docs/html/interfaces/DDResizeOpt.html b/docs/html/interfaces/DDResizeOpt.html
diff --git a/docs/html/interfaces/DDUIData.html b/docs/html/interfaces/DDUIData.html
diff --git a/docs/html/interfaces/DragTransform.html b/docs/html/interfaces/DragTransform.html
diff --git a/docs/html/interfaces/GridHTMLElement.html b/docs/html/interfaces/GridHTMLElement.html
diff --git a/docs/html/interfaces/GridItemHTMLElement.html b/docs/html/interfaces/GridItemHTMLElement.html
diff --git a/docs/html/interfaces/GridStackEngineOptions.html b/docs/html/interfaces/GridStackEngineOptions.html
diff --git a/docs/html/interfaces/GridStackMoveOpts.html b/docs/html/interfaces/GridStackMoveOpts.html
diff --git a/docs/html/interfaces/GridStackNode.html b/docs/html/interfaces/GridStackNode.html
diff --git a/docs/html/interfaces/GridStackOptions.html b/docs/html/interfaces/GridStackOptions.html
diff --git a/docs/html/interfaces/GridStackPosition.html b/docs/html/interfaces/GridStackPosition.html
diff --git a/docs/html/interfaces/GridStackWidget.html b/docs/html/interfaces/GridStackWidget.html
diff --git a/docs/html/interfaces/HTMLElementExtendOpt.html b/docs/html/interfaces/HTMLElementExtendOpt.html
diff --git a/docs/html/interfaces/HeightData.html b/docs/html/interfaces/HeightData.html
diff --git a/docs/html/interfaces/MousePosition.html b/docs/html/interfaces/MousePosition.html
diff --git a/docs/html/interfaces/Position.html b/docs/html/interfaces/Position.html
diff --git a/docs/html/interfaces/Rect.html b/docs/html/interfaces/Rect.html
diff --git a/docs/html/interfaces/Responsive.html b/docs/html/interfaces/Responsive.html
diff --git a/docs/html/interfaces/Size.html b/docs/html/interfaces/Size.html
-Original file line number
+Diff line change
@@ Expand Up @@
     # Demo and API Documentation
-    Please visit http://gridstackjs.com and [these demos](http://gridstackjs.com/demo/), and complete [API documentation](https://github.com/gridstack/gridstack.js/tree/master/doc)
+    Please visit http://gridstackjs.com and [these demos](http://gridstackjs.com/demo/), and complete [API documentation](https://gridstack.github.io/gridstack.js/docs/html/) ([markdown](https://github.com/gridstack/gridstack.js/tree/master/doc))
     # Usage
@@ Expand Down @@