feat(codespaces): support for GitHub Codespaces

Author: jan-molak

.devcontainer/devcontainer.json

@@ -0,0 +1,52 @@
+{
+  "image": "ghcr.io/serenity-js/playwright:v1.56.1-noble",
+
+  "features": {
+    "ghcr.io/devcontainers/features/desktop-lite:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+
+  "forwardPorts": [
+    6080,
+    8080,
+    8181
+  ],
+  "portsAttributes": {
+    "6080": {
+      "label": "Desktop"
+    },
+    "8080": {
+      "label": "Serenity Reports"
+    },
+    "8181": {
+      "label": "Playwright Reports"
+    }
+  },
+  "postCreateCommand": {
+    "Install": "npm ci",
+    "Welcome": "sudo cp .devcontainer/first-run-notice.txt /workspaces/.codespaces/shared/first-run-notice.txt"
+  },
+  "waitFor": "postCreateCommand",
+  "postAttachCommand": {
+    "Serenity/JS Test Run": "npm test",
+    "Serenity Reports Preview": "npx http-server -p 8080 target/site/serenity/",
+    "Playwright Reports Preview": "npx http-server -p 8181 playwright-report"
+  },
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "dbaeumer.vscode-eslint",
+        "editorconfig.editorconfig",
+        "eamodio.gitlens",
+        "ms-playwright.playwright",
+        "stateful.runme"
+      ],
+      "settings": {
+        "workbench.editorAssociations": {
+          "*.md": "runme"
+        }
+      }
+    }
+  }
+}

.devcontainer/first-run-notice.txt

@@ -0,0 +1,9 @@
+👋 Welcome to your Serenity/JS GitHub Codespace!
+
+🛠️ Your environment is fully configured and ready for you to explore the Serenity/JS framework.
+
+🚀 Once the setup process in the terminal completes:
+    - Open the port labeled "Serenity Reports" to view the test execution reports.
+    - Open the port labeled "Playwright Report" to explore detailed Playwright test results.
+
+ℹ️ Learn more at 👉 https://serenity-js.org/