feat: monorepo modernization — pnpm 11 + Node 24, Docusaurus docs, React <Apollon> API, VS Code rewrite (#691)

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: Ravi Tamang <40029376+tamang29@users.noreply.github.com>

Author: 3 people

.dockerignore

@@ -1,6 +1,7 @@
 .git
 .github
 .gitignore
+.husky
 .context
 .env
 .env.*
@@ -16,15 +17,29 @@ test-results/
 *.log
 
 node_modules/
+**/node_modules/
 dist/
+**/dist/
+
+**/tests/
+**/__tests__/
+**/*.test.ts
+**/*.test.tsx
+**/*.spec.ts
+**/playwright.config.ts
+**/vitest.config.ts
 
-standalone/webapp/dist
-standalone/webapp/node_modules
 standalone/webapp/android
 standalone/webapp/ios
 
-standalone/server/dist
-standalone/server/node_modules
+# Keep the vscode-extension package.json files (pnpm install reads them
+# as workspace manifests), but drop the source.
+vscode-extension/src
+vscode-extension/menu/src
+vscode-extension/editor/src
+vscode-extension/menu/dist
+vscode-extension/editor/dist
+vscode-extension/dist
 
-library/node_modules
-library/dist
+scripts/
+.changeset/

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+pnpm-lock.yaml linguist-generated=true -diff merge=binary
+
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.svg text
+*.vsix binary

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -77,4 +77,4 @@ body:
     attributes:
       label: Web Console Output
       description: If applicable, copy output from the Web Console.
-      render: shell
+      render: shell

.github/workflows/build-and-push.yml

@@ -43,7 +43,10 @@ jobs:
               - 'docker/**'
               - 'nginx.conf'
               - 'package.json'
-              - 'package-lock.json'
+              - 'pnpm-lock.yaml'
+              - 'pnpm-workspace.yaml'
+              - '.npmrc'
+              - '.nvmrc'
               - 'tsconfig*.json'
               - '.github/workflows/build-and-push.yml'
 
@@ -68,7 +71,7 @@ jobs:
             dockerfile: ./standalone/server/Dockerfile
             image: ghcr.io/ls1intum/apollon/server
             context: .
-    uses: ls1intum/.github/.github/workflows/build-and-push-docker-image.yml@main
+    uses: ls1intum/.github/.github/workflows/build-and-push-docker-image.yml@c8ede985ff7999c28d7538cb32ae52bfb83f51b9 # main
     with:
       image-name: ${{ matrix.image }}
       docker-file: ${{ matrix.dockerfile }}

.github/workflows/deploy-prod.yml

@@ -47,7 +47,7 @@ permissions: {}
 jobs:
   deploy-db:
     if: ${{ inputs.deploy-db }}
-    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@main
+    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@c8ede985ff7999c28d7538cb32ae52bfb83f51b9 # main as of 2026-05-19
     with:
       environment: Production
       docker-compose-file: "./docker/compose.db.yml"
@@ -58,7 +58,7 @@ jobs:
 
   deploy-proxy:
     if: ${{ inputs.deploy-proxy }}
-    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@main
+    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@c8ede985ff7999c28d7538cb32ae52bfb83f51b9 # main as of 2026-05-19
     with:
       environment: Production
       docker-compose-file: "./docker/compose.proxy.yml"
@@ -69,7 +69,7 @@ jobs:
 
   deploy-app:
     if: ${{ inputs.deploy-app }}
-    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@main
+    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@c8ede985ff7999c28d7538cb32ae52bfb83f51b9 # main as of 2026-05-19
     with:
       environment: Production
       docker-compose-file: "./docker/compose.app.yml"

.github/workflows/deploy-staging.yml

@@ -47,7 +47,7 @@ permissions: {}
 jobs:
   deploy-db:
     if: ${{ inputs.deploy-db }}
-    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@main
+    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@c8ede985ff7999c28d7538cb32ae52bfb83f51b9 # main as of 2026-05-19
     with:
       environment: Staging
       docker-compose-file: "./docker/compose.db.yml"
@@ -58,7 +58,7 @@ jobs:
 
   deploy-proxy:
     if: ${{ inputs.deploy-proxy }}
-    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@main
+    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@c8ede985ff7999c28d7538cb32ae52bfb83f51b9 # main as of 2026-05-19
     with:
       environment: Staging
       docker-compose-file: "./docker/compose.proxy.yml"
@@ -69,7 +69,7 @@ jobs:
 
   deploy-app:
     if: ${{ inputs.deploy-app }}
-    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@main
+    uses: ls1intum/.github/.github/workflows/deploy-docker-compose.yml@c8ede985ff7999c28d7538cb32ae52bfb83f51b9 # main as of 2026-05-19
     with:
       environment: Staging
       docker-compose-file: "./docker/compose.app.yml"

.github/workflows/docs.yml

@@ -0,0 +1,99 @@
+name: Docs
+
+# - PR with docs changes: build a /-rooted bundle (preview)
+# - push to main with docs changes: build /Apollon/-rooted bundle, deploy
+#   to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "library/**"
+      - "pnpm-lock.yaml"
+      - "pnpm-workspace.yaml"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - "library/**"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: docs-${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build Docusaurus site
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    outputs:
+      is-production: ${{ steps.flag.outputs.is-production }}
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - uses: pnpm/action-setup@ac6db6d3c1f721f886538a378a2d73e85697340a # v6.0.8
+
+      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
+        with:
+          node-version-file: ".nvmrc"
+          cache: "pnpm"
+
+      - id: flag
+        run: |
+          if [[ "${{ github.event_name }}" == "push" && "${{ github.ref }}" == "refs/heads/main" ]]; then
+            echo "is-production=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "is-production=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - run: pnpm install --frozen-lockfile
+
+      # Library must be built first — the docs site imports
+      # `@tumaet/apollon` for the live embed on the homepage.
+      - run: pnpm --filter @tumaet/apollon run build
+
+      - uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5
+        with:
+          path: |
+            docs/.docusaurus
+            docs/node_modules/.cache
+          key: docusaurus-${{ steps.flag.outputs.is-production }}-${{ hashFiles('pnpm-lock.yaml') }}-${{ hashFiles('docs/**/*.{md,mdx,ts,tsx}') }}
+          restore-keys: |
+            docusaurus-${{ steps.flag.outputs.is-production }}-${{ hashFiles('pnpm-lock.yaml') }}-
+            docusaurus-${{ steps.flag.outputs.is-production }}-
+
+      - run: pnpm --filter @tumaet/apollon-docs run build
+        env:
+          DOCUSAURUS_BASE_URL: ${{ steps.flag.outputs.is-production == 'true' && '/Apollon/' || '/' }}
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: docs-build
+          path: docs/build
+          retention-days: 7
+          if-no-files-found: error
+
+      - if: steps.flag.outputs.is-production == 'true'
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3
+        with:
+          path: docs/build
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    if: needs.build.outputs.is-production == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4