(#996) (ENGTASKS-3631) Switch to Astro

.devcontainer/devcontainer.json

@@ -1,27 +1,34 @@
 // For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
-// https://github.com/microsoft/vscode-dev-containers/tree/v0.202.5/containers/dotnet
+// https://github.com/withastro/astro/blob/main/.devcontainer/with-mdx/devcontainer.json
 {
-	"name": "C# (.NET)",
-	"runArgs": ["--init"],
-	"build": {
-		"dockerfile": "Dockerfile",
-		"args": {
-			"VARIANT": "3.1-focal",
-			"NODE_VERSION": "20"
+    "name": "Node.js & TypeScript",
+    "image": "mcr.microsoft.com/devcontainers/typescript-node:1-20-bullseye",
+    "forwardPorts": [5086],
+    "portsAttributes": {
+        "5086": {
+            "label": "Astro",
+            "onAutoForward": "openBrowser"
+        }
+    },
+    "postAttachCommand": "yarn dev",
+    "customizations": {
+        "codespaces": {
+            "openFiles": ["README.md"]
+        },
+        "vscode": {
+            "extensions": [
+                "DavidAnson.vscode-markdownlint",
+                "shardulm94.trailing-spaces",
+                "nhoizey.gremlins",
+                "streetsidesoftware.code-spell-checker",
+                "bierner.emojisense",
+                "astro-build.astro-vscode",
+                "esbenp.prettier-vscode",
+                "unifiedjs.vscode-mdx",
+                "ms-vscode.vscode-typescript-next",
+                "dbaeumer.vscode-eslint"
+			]
 		}
-	},
-	"hostRequirements": {
-		"cpus": 4,
-		"memory": "8gb"
-	},
-	"settings": {},
-	"extensions": [
-		"ms-dotnettools.csharp",
-		"DavidAnson.vscode-markdownlint",
-		"shardulm94.trailing-spaces",
-		"nhoizey.gremlins",
-		"streetsidesoftware.code-spell-checker",
-		"bierner.emojisense"
-	],
-	"remoteUser": "vscode"
+    },
+    "remoteUser": "node"
 }

.dockerignore

@@ -0,0 +1,54 @@
+# build output
+dist/
+
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# git history
+.git
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# npm 
+npm-debug.log
+.coverage
+.coverage.*
+.env
+.aws
+
+# yarn 
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/
+
+# choco-theme
+public/fonts
+public/scripts
+public/styles
+public/images/global-shared
+
+# general
+apple-touch-*.png
+favicon.ico
+.astro

.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+[*.{js,json,yml}]
+charset = utf-8
+indent_style = space
+indent_size = 4

.gitattributes

@@ -0,0 +1,4 @@
+/.yarn/**            linguist-vendored
+/.yarn/releases/*    binary
+/.yarn/plugins/**/*  binary
+/.pnp.*              binary linguist-generated

.github/workflows/playwright.yml

@@ -0,0 +1,27 @@
+name: Playwright Tests
+
+on:
+  pull_request:
+    branches: [ main, master ]
+  workflow_dispatch:
+jobs:
+  test:
+    timeout-minutes: 60
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository using git
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Build site
+        run: yarn build
+      - name: Run Playwright tests
+        run: yarn playwright
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 14

.github/workflows/publish.yaml

@@ -1,37 +1,32 @@
 name: Publish Documentation
-on:
-    workflow_dispatch:
-    push:
-      branches:
-        - master
 
-jobs:
+on:
+  push:
+    branches: [ master ]
+  workflow_dispatch:
 
-  ###################################################
-  # DOCS
-  ###################################################
+# Allow this job to clone the repo and create a page deployment
+permissions:
+  contents: read
+  pages: write
+  id-token: write
 
+jobs:
   build:
-    name: Publish
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-      with:
-        fetch-depth: 0
-
-    - name: Setup dotnet
-      uses: actions/setup-dotnet@v1
-      with:
-        dotnet-version: '3.1.301' # SDK Version to use.
+      - name: Checkout repository using git
+        uses: actions/checkout@v4
+      - name: Install, build, and upload site
+        uses: withastro/action@v2
 
-    - name: Publish-Documentation
-      shell: bash
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        STATIQ_GITHUB_TOKEN: ${{ secrets.STATIQ_GITHUB_TOKEN }}
-        STATIQ_DEPLOY_BRANCH: ${{ secrets.STATIQ_DEPLOY_BRANCH }}
-        STATIQ_DEPLOY_REMOTE: ${{ secrets.STATIQ_DEPLOY_REMOTE }}
-      run: |
-        dotnet tool restore
-        dotnet cake --target=Publish-Documentation
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,26 +1,58 @@
-.dotnet/
-tools/
-BuildArtifacts/
-config.wyam.*
-.DS_Store
-output/
-bin/
-obj/
-publish/
+# build output
+dist/
+
+# generated types
+.astro/
+
+# dependencies
 node_modules/
-input/assets/css/
-input/assets/js/
-input/assets/fonts/
-input/assets/images/global-shared/
-input/global-partials/
-apple-touch-*.png
-favicon.ico
-cache/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# npm 
+npm-debug.log
+.coverage
+.coverage.*
+.env
+.aws
+
+# yarn 
 .pnp.*
 .yarn/*
 !.yarn/patches
 !.yarn/plugins
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
-.directory
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/
+
+# choco-theme
+public/fonts
+public/scripts
+public/styles
+public/images/global-shared
+
+# general
+apple-touch-*.png
+favicon.ico
+.astro
+
+# playwright
+/src/tests/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/

.markdownlint.json

@@ -1,9 +1,9 @@
 {
-  "MD026": false,
-  "MD013": false,
-  "MD024": false,
-  "MD034": false,
-  "MD033": {
-    "allowed_elements": ["details", "strong", "summary"]
-  }
-}
+    "MD026": false,
+    "MD013": false,
+    "MD024": false,
+    "MD034": false,
+    "MD033": {
+        "allowed_elements": ["details", "strong", "summary"]
+    }
+}

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}