Add Dev Container Support

.devcontainer/Dockerfile

@@ -0,0 +1,20 @@
+FROM mcr.microsoft.com/devcontainers/python:1-3.13-bookworm
+
+RUN rm -f /etc/apt/sources.list.d/yarn.list /etc/apt/sources.list.d/nodesource.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends \
+        curl \
+        git \
+        bash \
+        build-essential \
+        libgl1 \
+        libglib2.0-0 \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends nodejs \
+    && npm install -g npm@latest \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /workspaces/bambuddy

.devcontainer/devcontainer.json

@@ -0,0 +1,43 @@
+{
+  "name": "Bambuddy Dev",
+  "dockerComposeFile": "docker-compose.yml",
+  "service": "app",
+  "workspaceFolder": "/workspaces/bambuddy",
+  "remoteUser": "vscode",
+  "forwardPorts": [8000, 5173],
+  "portsAttributes": {
+    "8000": {
+      "label": "Bambuddy Backend",
+      "onAutoForward": "notify"
+    },
+    "5173": {
+      "label": "Vite Frontend",
+      "onAutoForward": "openPreview"
+    }
+  },
+  "postCreateCommand": "python -m pip install --upgrade pip && pip install -r requirements.txt -r requirements-dev.txt && mkdir -p /home/vscode/.npm && sudo chown -R vscode:vscode /home/vscode/.npm && sudo rm -rf frontend/node_modules && cd frontend && npm ci",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "charliermarsh.ruff",
+        "ms-azuretools.vscode-docker",
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/usr/local/bin/python",
+        "python.analysis.typeCheckingMode": "basic",
+        "editor.formatOnSave": true,
+        "[python]": {
+          "editor.defaultFormatter": "charliermarsh.ruff"
+        },
+        "editor.codeActionsOnSave": {
+          "source.organizeImports": "explicit",
+          "source.fixAll.ruff": "explicit"
+        }
+      }
+    }
+  }
+}

.devcontainer/docker-compose.yml

@@ -0,0 +1,20 @@
+services:
+  app:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+    command: sleep infinity
+    volumes:
+      - ..:/workspaces/bambuddy:cached
+      - bambuddy-pip-cache:/home/vscode/.cache/pip
+      - bambuddy-npm-cache:/home/vscode/.npm
+    environment:
+      PYTHONUNBUFFERED: "1"
+      PIP_DISABLE_PIP_VERSION_CHECK: "1"
+      DEBUG: "true"
+      BACKEND_PORT: "8000"
+      DEVCONTAINER: "true"
+
+volumes:
+  bambuddy-pip-cache:
+  bambuddy-npm-cache:

README.md

@@ -475,6 +475,42 @@ services:
 
 </details>
 
+#### DevContainer (VS Code)
+
+Use the included `.devcontainer/` setup for a consistent development environment.
+
+**Prerequisites:**
+- Docker
+- VS Code with the Dev Containers extension
+
+```bash
+# from repository root
+code .
+```
+
+Then run **"Dev Containers: Reopen in Container"** from the command palette.
+
+Inside the container, start the app in two terminals:
+
+```bash
+# Terminal 1 (backend)
+DEBUG=true uvicorn backend.app.main:app --reload
+
+# Terminal 2 (frontend)
+cd frontend && npm run dev
+```
+
+Ports `8000` (backend) and `5173` (frontend) are forwarded automatically.
+
+**Troubleshooting:**
+If container creation fails early (for example with `devContainersSpecCLI ... Exit code 1`), run:
+
+```bash
+docker compose -f .devcontainer/docker-compose.yml build --no-cache app
+```
+
+Then use **"Dev Containers: Rebuild and Reopen in Container"** in VS Code.
+
 #### Windows (Portable Launcher)
 
 The easiest way to run Bambuddy on Windows - no installation required:

frontend/vite.config.ts

@@ -14,6 +14,7 @@ export default defineConfig({
     chunkSizeWarningLimit: 3000,
   },
   server: {
+    host: process.env.DEVCONTAINER === 'true' ? '0.0.0.0' : undefined,
     proxy: {
       '/api/v1/ws': {
         target: backendUrl,