feat(tooling): add devcontainer environment configuration

Author: phroi

.devcontainer/devcontainer.json

@@ -0,0 +1,64 @@
+{
+  // Display name shown by editor when selecting this dev container
+  "name": "${localWorkspaceFolderBasename} Dev Environment",
+
+  // Base image from Microsoft devcontainers for a TypeScript + Node environment
+  "image": "mcr.microsoft.com/devcontainers/typescript-node",
+
+  // Persisted volumes to speed installs and preserve build artifacts between container restarts
+  "mounts": [
+    // Persist node_modules so reinstalling or rebuilding the container doesn't force repeated network installs
+    "source=${localWorkspaceFolderBasename}-node_modules,target=${containerWorkspaceFolder}/node_modules,type=volume",
+
+    // Persist built outputs (dist) to avoid losing compiled artifacts across container restarts
+    "source=${localWorkspaceFolderBasename}-dist,target=${containerWorkspaceFolder}/dist,type=volume",
+
+    // Share a pnpm store cache volume to speed package resolution and install times across projects/containers
+    "source=pnpm-cache,target=${containerWorkspaceFolder}/.pnpm-store,type=volume"
+  ],
+
+  // Run once after the container filesystem is created.
+  // - Fix ownership so the non-root node user can access workspace files
+  // - Install latest pnpm globally so postStartCommand and developer workflows use pnpm
+  "postCreateCommand": "sudo chown node -R . /home && npm install -g pnpm@latest",
+
+  // Run each time the container starts. Ensures dependencies are installed inside the container user environment.
+  "postStartCommand": "pnpm install --frozen-lockfile",
+
+  // Use the non-root 'node' user provided by the base image for safer file access and to mirror deployment permissions
+  "remoteUser": "node",
+
+  "customizations": {
+    "vscode": {
+      // Recommended and enforced editor settings for consistent linting/validation across contributors
+      "settings": {
+        // Prefer editor config over global formatting where appropriate
+        "editor.formatOnSave": true,
+        "editor.codeActionsOnSave": {
+          "source.fixAll.eslint": "explicit"
+        },
+        "eslint.validate": [
+          "json",
+          "javascript",
+          "javascriptreact",
+          "typescript",
+          "typescriptreact"
+        ],
+        // Disable telemetry to avoid sending usage data to Microsoft
+        "telemetry.enableTelemetry": false
+      },
+
+      // Recommended extensions preinstalled in the container to provide a consistent developer experience
+      "extensions": [
+        "streetsidesoftware.code-spell-checker", // basic spell checking in docs/comments
+        "bradlc.vscode-tailwindcss", // Tailwind CSS IntelliSense if project uses Tailwind
+        "dbaeumer.vscode-eslint", // ESLint integration for linting and autofix
+        "esbenp.prettier-vscode", // Prettier for consistent formatting
+        "yoavbls.pretty-ts-errors", // Improved TypeScript error messages
+        "davidanson.vscode-markdownlint", // Markdown linting for docs
+        "github.vscode-github-actions", // GitHub Actions workflow support
+        "github.vscode-pull-request-github" // PR and issue integration with GitHub
+      ]
+    }
+  }
+}

.gitignore

@@ -12,3 +12,5 @@ packages/*/dist*
 .env*
 
 *.DS_Store
+
+.pnpm-store