create-node-lib 2.15.2 → 2.15.3

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [2.15.3](https://github.com/lirantal/create-node-lib/compare/v2.15.2...v2.15.3) (2026-04-12)
+
+
+### Bug Fixes
+
+* port mapping in devcontainer ([a0277a5](https://github.com/lirantal/create-node-lib/commit/a0277a59370f66e332d11231bcaab2f11eca41c9))
+
 ## [2.15.2](https://github.com/lirantal/create-node-lib/compare/v2.15.1...v2.15.2) (2026-04-12)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-node-lib",
-  "version": "2.15.2",
+  "version": "2.15.3",
   "description": "Scaffolding out a Node.js library module",
   "bin": "./bin/cli.js",
   "engines": {

package/template/.devcontainer/devcontainer.json

@@ -10,6 +10,15 @@
             "shellautocompletion": true
         }
     },
+    // forwardPorts: VS Code / Cursor Ports UI, auto-forward, portsAttributes (spec “forwarding”).
+    "forwardPorts": [
+        5959
+    ],
+    // appPort: Docker publish (127.0.0.1:port:port) for @devcontainers/cli — e.g. .devcontainer/start.sh.
+    // Editors still apply appPort when they create the container; keep this list aligned with forwardPorts.
+    "appPort": [
+        5959
+    ],
     "mounts": [
         "source=${localEnv:HOME}/.gitconfig,target=/home/node/.gitconfig,type=bind,consistency=cached",
         // mount host user home directories for agents:

package/template/.devcontainer/start.sh

@@ -1,10 +1,80 @@
-#!/bin/bash
+#!/usr/bin/env bash
+#
+# @file start.sh
+# @summary Start the Dev Container for this workspace and attach an interactive shell.
+#
+# Uses @devcontainers/cli to run `devcontainer up` then `devcontainer exec bash`.
+# Host port publishing for this script comes from **appPort** — @devcontainers/cli maps it
+# to `docker -p`. It does **not** map **forwardPorts** to Docker (editors use forwardPorts
+# for Ports UI / tunneling; they still apply **appPort** when creating the container).
+#
+# @usage
+#   .devcontainer/start.sh [options]
+#
+# @options
+#   --recreate  Remove the existing dev container for this workspace before `up`, so
+#               changes to appPort (or other create-time settings) take effect.
+#   --help, -h  Print usage and exit.
+#
+# @example
+#   .devcontainer/start.sh
+#   .devcontainer/start.sh --recreate
+#
+
 set -e
 
-WORKSPACE_FOLDER="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORKSPACE_FOLDER="$(cd "$SCRIPT_DIR/.." && pwd)"
+CLI_VERSION="0.84.1"
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Start the dev container for:
+  $WORKSPACE_FOLDER
+
+Then open an interactive bash session inside the container.
+
+Options:
+  --recreate    Remove the existing dev container for this workspace before starting,
+                so Docker picks up new settings (e.g. appPort / port mappings).
+  --help, -h    Show this help and exit.
+
+Notes:
+  For devcontainer up from the terminal, Docker publish uses appPort. Keep appPort and
+  forwardPorts lists in sync if you use both this script and VS Code / Cursor.
+EOF
+}
+
+RECREATE=false
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --help | -h)
+      usage
+      exit 0
+      ;;
+    --recreate)
+      RECREATE=true
+      shift
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      echo "Run with --help for usage." >&2
+      exit 1
+      ;;
+  esac
+done
 
 echo "Starting devcontainer for: $WORKSPACE_FOLDER"
-npx --yes @devcontainers/cli@0.84.1 up --workspace-folder "$WORKSPACE_FOLDER"
+
+UP_ARGS=(--workspace-folder "$WORKSPACE_FOLDER")
+if [ "$RECREATE" = true ]; then
+  UP_ARGS+=(--remove-existing-container)
+  echo "Removing existing dev container so create-time settings (e.g. appPort) apply."
+fi
+
+npx --yes "@devcontainers/cli@${CLI_VERSION}" up "${UP_ARGS[@]}"
 
 echo "Dropping into container shell..."
-npx --yes @devcontainers/cli@0.84.1 exec --workspace-folder "$WORKSPACE_FOLDER" bash
+npx --yes "@devcontainers/cli@${CLI_VERSION}" exec --workspace-folder "$WORKSPACE_FOLDER" bash