Reapply webapp refactor with latest data (#155)

Re-applies #153 (reverted by #154) on top of current master, but places the
latest generated api_info.json / api_examples.json / proj_info.json at webapp/src/
so the deployed build has data (fixes 'Failed to load API data').

Built cleanly off current master instead of reverting #154, which conflicts because
the docify bot (b400a1c) modified the data files after the revert.

Follow-up: update the docify generation workflow to target docify/webapp/src.


Claude-Session: https://claude.ai/code/session_012Qrsj2mgcneyw2XNJwpLtV

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: karimi

.github/workflows/deploy.yaml

@@ -2,35 +2,41 @@ name: Heroku build and deploy
 
 on:
   push:
-    branches: [ 'master' ]
-  pull_request:
-    branches: [ 'master' ]
+    branches: ['master']
   workflow_dispatch:
-    branches:
-      - master
 
 jobs:
   build_deploy:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - name: build
-      run: |
-        cd quasar_site/
-        yarn
-        yarn ssrbuild
-    - name: deploy
-      run: |
-        cd quasar_site/dist/ssr/
-        git init
-        git config user.email "morteza@mcneel.com"
-        git config user.name "Morteza Karimi"
-        git remote add heroku https://heroku:${{ secrets.HEROKU_API_KEY }}@git.heroku.com/mcneel-apidocs.git
-        git add .
-        git commit -m "CI build"
-        git push heroku master --force
-
-    - name: invalidate cache
-      run: |
-        curl --location 'https://api.mcneel.com/cloudfront/invalidate' --header 'Authorization: Basic ${{ secrets.BOZO_API_KEY }}' --header 'Content-Type: application/json' --data '{"url":"https://developer.rhino3d.com/api/*"}'
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: build
+        run: |
+          cd webapp/
+          yarn
+          yarn build
+      - name: stage static deploy artifact
+        run: |
+          cd webapp/
+          rm -rf deploy && mkdir deploy
+          cp -r dist deploy/dist
+          cp server.js deploy/server.js
+          cp Procfile deploy/Procfile
+          cp deploy.package.json deploy/package.json
+      - name: deploy to heroku
+        run: |
+          cd webapp/deploy/
+          git init
+          git config user.email "morteza@mcneel.com"
+          git config user.name "Morteza Karimi"
+          git remote add heroku https://heroku:${{ secrets.HEROKU_API_KEY }}@git.heroku.com/mcneel-apidocs.git
+          git add .
+          git commit -m "CI build"
+          git push heroku HEAD:master --force
 
+      - name: invalidate cache
+        run: |
+          curl --location 'https://api.mcneel.com/cloudfront/invalidate' --header 'Authorization: Basic ${{ secrets.BOZO_API_KEY }}' --header 'Content-Type: application/json' --data '{"url":"https://developer.rhino3d.com/api/*"}'

.vscode/tasks.json

@@ -24,7 +24,7 @@
           "init",
           "RhinoCommon",
           "--force",
-          "--target=${workspaceFolder}/quasar_site/src",
+          "--target=${workspaceFolder}/webapp/src",
           "--source=${input:rhinoSource}/src4/DotNetSDK/rhinocommon/dotnet",
           "--examples=${input:rhinoSource}/src4/DotNetSDK/rhinocommon"
         ],
@@ -48,21 +48,21 @@
         "problemMatcher": []
       },
       {
-        "label": "run quasar",
-        "command": "quasar",
+        "label": "run webapp",
+        "command": "yarn",
         "type": "process",
         "args": ["dev"],
         "options": {
-          "cwd": "${workspaceFolder}/quasar_site"
+          "cwd": "${workspaceFolder}/webapp"
         },
         "problemMatcher": "$msCompile"
       },
       {
-        "label": "initial setup (npm)",
+        "label": "initial setup",
         "type": "shell",
-        "command": "npm install && npm run lint",
+        "command": "yarn",
         "options": {
-          "cwd": "${workspaceFolder}/quasar_site"
+          "cwd": "${workspaceFolder}/webapp"
         },
         "problemMatcher": []
       }

README.md

@@ -3,13 +3,13 @@ Project for generating Rhino/Grasshopper API documentation. This repo is split i
 
 # src 
 src contains a Visual Studio project (api_docify) that parses source code and generates markdown and json files that represent the public facing API for a project
-# quasar_site
-a quasar project that creates a web site based on the json files created. This site currently gets published to heroku and can be viewed at
+# webapp
+a Vue 3 + Vite + Tailwind + Pinia SPA that creates a web site based on the json files created. This site currently gets published to heroku and can be viewed at
 
 https://mcneel-apidocs.herokuapp.com/api/rhinocommon/
 
-Instructions for building and testing the quasar site can be found at
-[quasar site readme](quasar_site/readme.md)
+Instructions for building and testing the web app can be found at
+[web app readme](webapp/README.md)
 
 
 ## Usage
@@ -22,17 +22,16 @@ $ api_docify --name=<proj_name> <proj_path> <proj_output_js> <examples_path> <ex
 **Example**
 
 ```shell
-$ api_docify.exe --name="RhinoCommon" "%RHINO4SRC%/rhinocommon/dotnet" "src/modules/docify/quasar_site/src/RhinoCommonApi.js"
+$ api_docify.exe --name="RhinoCommon" "%RHINO4SRC%/rhinocommon/dotnet" "src/modules/docify/webapp/src/RhinoCommonApi.js"
 ```
 
 # VS Code (Mac) setup instructions
 
-1. Ensure node, npm, and quasar are installed
+1. Ensure node and yarn are installed
 2. Open this folder in VS Code
-3. Run `CMD+Shift+P > Run Task > initial setup (npm)` 
-4. Run `CMD+Shift+P > Run Task > docify init`, then enter the path where the Rhino source code is located and press enter.
-5. Run `CMD+Shift+P > Run Task > docify build`
-5. Run `CMD+Shift+P > Run Task > run quasar`
+3. Run `cd webapp && yarn` to install dependencies
+4. Run `CMD+Shift+P > Run Task > docify build` (or run the generator) to produce the JSON
+5. Run `cd webapp && yarn dev` to start the site
 
 ## Troubleshooting