docker-compose.yml

# Development and testing environment for the Web UI.
#
#   docker compose up webui                  # run the branch's built Web UI
#   → http://localhost:18080/?token=dev-token
#
#   docker compose run --rm -p 18080:18080 dev # interactive dev shell over the
#                                            # mounted source; then inside:
#                                            #   pnpm install && pnpm build
#                                            #   node dist/cli.js webui --host 0.0.0.0 --no-open
#
# Clean environment by design: NO host home directories are mounted. The
# MiniMax API key comes from the environment and is seeded into a fresh
# in-container ~/.minimax/config.yaml by docker/entrypoint.sh — every
# collaborator tests with their own key and a factory-fresh state, so host
# models/tools/sessions never leak in (and container state never leaks out).
#
#   MINIMAX_CN_API_KEY=...  docker compose up webui     # region cn
#   MINIMAX_API_KEY=...     docker compose up webui     # region global
#
# The token is fixed for dev convenience (WEBUI_TOKEN). The host browser is a
# non-local client from the container's point of view, so every URL needs
# ?token=… or an Authorization header.

services:
  webui:
    build: .
    image: mcode-webui:dev
    init: true
    environment:
      TOKEN: ${WEBUI_TOKEN:-dev-token}
      PORT: ${WEBUI_PORT:-18080}
      MINIMAX_CN_API_KEY: ${MINIMAX_CN_API_KEY:-}
      MINIMAX_API_KEY: ${MINIMAX_API_KEY:-}
      MAVIS_REGION: ${MAVIS_REGION:-}
    ports:
      - "${WEBUI_PORT:-18080}:${WEBUI_PORT:-18080}"
    restart: unless-stopped

  dev:
    image: mcode-webui:dev
    init: true
    working_dir: /repo
    environment:
      PORT: ${WEBUI_PORT:-18080}
      # Keep package-manager state inside the container, off the bind mounts.
      XDG_DATA_HOME: /tmp/xdg
      PNPM_HOME: /tmp/pnpm
      MINIMAX_CN_API_KEY: ${MINIMAX_CN_API_KEY:-}
      MINIMAX_API_KEY: ${MINIMAX_API_KEY:-}
      MAVIS_REGION: ${MAVIS_REGION:-}
    command: sleep infinity
    volumes:
      - .:/repo
    profiles: ["dev"]