refactor(devcontainer): restructure with project-specific templates

.vscode/extensions.json

@@ -1,7 +1,8 @@
 {
     "recommendations": [
+        "davidanson.vscode-markdownlint",
         "ms-azuretools.vscode-containers",
+        "redhat.vscode-yaml",
         "streetsidesoftware.code-spell-checker",
-        "redhat.vscode-yaml"
     ]
 }

README.md

@@ -1,6 +1,6 @@
 # VS Code Dev Container Playground
 
-This repository provides a template-based workflow for VS Code Dev Containers. Shared settings live under `compose-base/`, and each local dev container is created by copying `projects/.template/` into `projects/`.
+This repository provides a template-based workflow for VS Code Dev Containers. Each local dev container is created by copying `projects/.template/` into `projects/`.
 
 ## Getting Started
 
@@ -9,11 +9,6 @@ Prerequisites: Docker is available on the host, and VS Code has the `ms-vscode-r
 1. Download the repository (e.g., `git clone https://github.com/iplaylf2/vscode-container.git`).
 2. Copy `projects/.template/` to `projects/<your-project-name>`.
 3. Edit `projects/<your-project-name>/docker-compose.yaml` as needed.
-4. Set `VSCODE_CONTAINER_PROJECT` in the host environment that will launch VS Code.
-5. Open `projects/<your-project-name>` in VS Code and run `Dev Containers: Reopen in Container`.
+4. Open `projects/<your-project-name>` in VS Code and run `Dev Containers: Reopen in Container`.
 
-After the container is created, VS Code opens the workspace at `/mnt/${VSCODE_CONTAINER_PROJECT}`. The data lives in a Docker volume named `${VSCODE_CONTAINER_PROJECT}`.
-
-## Configuration Notes
-
-- `VSCODE_CONTAINER_PROJECT` provides the project identity (volume name and `/mnt/<project>` path); it is an environment variable because `devcontainer.json` cannot pass variables into Docker Compose.
+After the container is created, VS Code opens the workspace at `/mnt/<your-project-name>`. The data lives in a Docker volume named `<your-project-name>_workspace`.

features/fnm/devcontainer-feature.json

@@ -0,0 +1,13 @@
+{
+  "id": "fnm",
+  "version": "1.0.0",
+  "name": "Fast Node Manager (fnm)",
+  "description": "Installs fnm and optionally a Node.js version.",
+  "options": {
+    "nodeVersion": {
+      "type": "string",
+      "default": "lts",
+      "description": "Node.js version to install with fnm. Use 'none' to skip."
+    }
+  }
+}

features/fnm/install.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+if [ -z "${BASH_VERSION:-}" ] || [ "$(id -un)" != "$_REMOTE_USER" ]; then
+  exec su "$_REMOTE_USER" -c "bash -lc '$0'"
+fi
+
+set -euo pipefail
+
+curl -fsSL https://fnm.vercel.app/install | bash
+
+FNM_PATH="$HOME/.local/share/fnm"
+export PATH="$FNM_PATH:$PATH"
+
+NODE_VERSION="${NODE_VERSION:-lts}"
+if [ "$NODE_VERSION" != "none" ]; then
+  if [ "$NODE_VERSION" = "lts" ]; then
+    fnm install --lts
+  else
+    fnm install "$NODE_VERSION"
+  fi
+fi

features/uv/devcontainer-feature.json

@@ -0,0 +1,13 @@
+{
+  "id": "uv",
+  "version": "1.0.0",
+  "name": "uv",
+  "description": "Installs uv and optionally a Python version.",
+  "options": {
+    "pythonVersion": {
+      "type": "string",
+      "default": "3",
+      "description": "Python version to install with uv. Use 'none' to skip."
+    }
+  }
+}

features/uv/install.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+if [ -z "${BASH_VERSION:-}" ] || [ "$(id -un)" != "$_REMOTE_USER" ]; then
+  exec su "$_REMOTE_USER" -c "bash -lc '$0'"
+fi
+
+set -euo pipefail
+
+curl -fsSL https://astral.sh/uv/install.sh | sh
+. "$HOME/.local/bin/env"
+
+PYTHON_VERSION="${PYTHON_VERSION:-3}"
+if [ "$PYTHON_VERSION" != "none" ]; then
+  uv python install --default "$PYTHON_VERSION"
+fi

projects/.template/.devcontainer/devcontainer.json

@@ -1,11 +1,11 @@
 {
-	"name": "${localEnv:VSCODE_CONTAINER_PROJECT}",
-	"dockerComposeFile": [
-		"../../../compose-base/docker-compose.yaml",
-		"../docker-compose.yaml"
+	"dockerComposeFile": "../docker-compose.yaml",
+	"mounts": [
+		"source=workspace,target=${containerWorkspaceFolder},type=volume"
 	],
+	"name": "${localWorkspaceFolderBasename}",
+	"overrideCommand": true,
+	"postCreateCommand": "sudo chown $(id -un) ${containerWorkspaceFolder}",
 	"service": "devcontainer",
-	"workspaceFolder": "/mnt/${localEnv:VSCODE_CONTAINER_PROJECT}",
-	"postCreateCommand": "sudo chown vscode ${containerWorkspaceFolder}",
-	"overrideCommand": true
-}
+	"workspaceFolder": "/mnt/${localWorkspaceFolderBasename}"
+}

projects/.template/docker-compose.yaml

@@ -1,9 +1,8 @@
 services:
   devcontainer:
-    # Base settings come from ../../compose-base/docker-compose.yaml via dockerComposeFile.
     build:
       # Pick the Dockerfile that matches your dev environment.
-      dockerfile: images/base/Dockerfile
+      dockerfile: ../../images/base/Dockerfile
       args:
         # Optional: toolchain version for Dockerfiles that accept SDK_VERSION.
         SDK_VERSION: 0