docs: add Cypress testing dependencies documentation with OS-specific scripts

Move Cypress dependency installation from CI workflow into documented
scripts for better maintainability and user guidance. Add OS-specific
tabs in documentation for Ubuntu 22.04, Ubuntu 24.04, and macOS.

Changes:
- Create OS-specific scripts for installing Cypress dependencies
- Update CI workflow to use the new scripts
- Add Testing dependencies section to frontend documentation with tabs
- Include macOS support for Cypress testing in CI

Author: dannywillems

.github/workflows/test-docs-scripts-frontend.yaml

@@ -102,13 +102,11 @@ jobs:
       - name: Prepare for Cypress tests (Ubuntu 22.04)
         if: matrix.os == 'ubuntu-22.04'
         run: |
-          sudo apt-get update
-          sudo apt-get install -y libgtk2.0-0 libgtk-3-0 libgbm-dev libnotify-dev \
-            libnss3 libxss1 libasound2 libxtst6 xauth xvfb
+          bash website/docs/developers/scripts/frontend/install-cypress-deps-ubuntu-22-04.sh
 
       - name: Prepare for Cypress tests (Ubuntu 24.04)
         if: matrix.os == 'ubuntu-24.04'
         run: |
-          sudo apt-get update
-          sudo apt-get install -y libgtk2.0-0 libgtk-3-0 libgbm-dev libnotify-dev \
-            libnss3 libxss1 libasound2t64 libxtst6 xauth xvfb
+          bash website/docs/developers/scripts/frontend/install-cypress-deps-ubuntu-24-04.sh
+
+      # Note: Cypress works out of the box on macOS, no additional dependencies needed

website/docs/developers/frontend/index.mdx

@@ -10,6 +10,8 @@ import TabItem from "@theme/TabItem";
 import InstallNodejsLinux from "!!raw-loader!../scripts/frontend/install-nodejs-linux.sh";
 import InstallNodejsMacos from "!!raw-loader!../scripts/frontend/install-nodejs-macos.sh";
 import InstallAngularCli from "!!raw-loader!../scripts/frontend/install-angular-cli.sh";
+import InstallCypressUbuntu2204 from "!!raw-loader!../scripts/frontend/install-cypress-deps-ubuntu-22-04.sh";
+import InstallCypressUbuntu2404 from "!!raw-loader!../scripts/frontend/install-cypress-deps-ubuntu-24-04.sh";
 
 # Frontend Applications
 
@@ -145,6 +147,53 @@ set.
 
 <!-- prettier-ignore-stop -->
 
+## Testing dependencies
+
+### Cypress end-to-end testing
+
+The frontend applications use Cypress for end-to-end testing. Cypress requires
+additional system dependencies to run browser automation tests.
+
+<Tabs>
+<TabItem value="ubuntu-22-04" label="Ubuntu 22.04">
+
+<CodeBlock
+  language="bash"
+  title="scripts/frontend/install-cypress-deps-ubuntu-22-04.sh"
+>
+  {InstallCypressUbuntu2204}
+</CodeBlock>
+
+</TabItem>
+<TabItem value="ubuntu-24-04" label="Ubuntu 24.04">
+
+<CodeBlock
+  language="bash"
+  title="scripts/frontend/install-cypress-deps-ubuntu-24-04.sh"
+>
+  {InstallCypressUbuntu2404}
+</CodeBlock>
+
+</TabItem>
+</Tabs>
+
+<!-- prettier-ignore-start -->
+
+:::info Cypress Dependencies
+
+These dependencies are required for:
+
+- Running Cypress in headless mode (CI/CD environments)
+- Displaying the Cypress Test Runner GUI locally
+- Browser automation and screenshot capabilities
+
+**Note for macOS users:** Cypress typically works out of the box on macOS with
+system browsers. No additional dependencies need to be installed.
+
+:::
+
+<!-- prettier-ignore-stop -->
+
 ## Next Steps
 
 With Node.js and Angular CLI installed, you're ready to build and run any of the

website/docs/developers/scripts/frontend/install-cypress-deps-ubuntu-22-04.sh

@@ -0,0 +1,6 @@
+# Install Cypress dependencies for Ubuntu 22.04
+# These packages are required for running Cypress end-to-end tests
+
+sudo apt-get update
+sudo apt-get install -y libgtk2.0-0 libgtk-3-0 libgbm-dev libnotify-dev \
+  libnss3 libxss1 libasound2 libxtst6 xauth xvfb

website/docs/developers/scripts/frontend/install-cypress-deps-ubuntu-24-04.sh

@@ -0,0 +1,7 @@
+# Install Cypress dependencies for Ubuntu 24.04
+# These packages are required for running Cypress end-to-end tests
+# Note: libasound2t64 is used instead of libasound2 in Ubuntu 24.04
+
+sudo apt-get update
+sudo apt-get install -y libgtk2.0-0 libgtk-3-0 libgbm-dev libnotify-dev \
+  libnss3 libxss1 libasound2t64 libxtst6 xauth xvfb