feat(codespaces): support for GitHub Codespaces

Author: jan-molak

.devcontainer/devcontainer.json

@@ -0,0 +1,46 @@
+{
+  "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
+  ],
+  "portsAttributes": {
+    "6080": {
+      "label": "Desktop"
+    },
+    "8080": {
+      "label": "Serenity 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/"
+  },
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "dbaeumer.vscode-eslint",
+        "editorconfig.editorconfig",
+        "eamodio.gitlens",
+        "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/

package.json

@@ -31,7 +31,7 @@
   },
   "homepage": "https://serenity-js.org",
   "engines": {
-    "node": "^18.12 || ^20 || ^22 || ^24.0.0"
+    "node": "^20 || ^22 || ^24"
   },
   "devDependencies": {
     "@cucumber/cucumber": "^11.3.0",