Update version to 2.2.0, add --public option for Docker accessibility, and enhance Docker build process for multi-architecture support. Update README and Dockerfile to reflect changes.

Author: claudio-silva

npx/README.md

@@ -1,4 +1,4 @@
-# run-claude-artifact v2.1.0
+# run-claude-artifact v2.2.0
 
 This npm package exposes the `run-claude-artifact` command for use with `npx`.
 

npx/docker/Dockerfile

@@ -6,12 +6,14 @@ RUN apk add --no-cache git
 # Set working directory
 WORKDIR /app
 
-# Install the run-claude-artifact package globally
-RUN npm install -g run-claude-artifact@latest
+# Clear npm cache and install the run-claude-artifact package globally
+# Using --force ensures we get the latest version even if cached
+RUN npm cache clean --force && \
+    npm install -g run-claude-artifact@latest --force
 
 # Create entrypoint script that forwards arguments to npx
 RUN echo '#!/bin/sh' > /entrypoint.sh && \
-    echo 'exec npx run-claude-artifact --no-open "$@"' >> /entrypoint.sh && \
+    echo 'exec npx run-claude-artifact --no-open --public "$@"' >> /entrypoint.sh && \
     chmod +x /entrypoint.sh
 
 # Set entrypoint

npx/docker/README.md

@@ -4,7 +4,7 @@ The project includes a Docker image that can be used as an alternative to `npx r
 
 ### Building the Docker Image
 
-Run the build script:
+Run the build script for **local testing**:
 
 ```bash
 npx/docker/build
@@ -14,6 +14,9 @@ The script will:
 - Build the Docker image with both version and `latest` tags
 - Read the version from `npx/package.json`
 - Display the created tags
+- Build for your current platform (useful for local testing)
+
+**Note:** The build script is for local testing only. When publishing, the publish script will rebuild the image anyway, so you don't need to run build first.
 
 The Dockerfile installs Node.js v23.11.0 (which includes npx) and the `run-claude-artifact` npm package globally.
 
@@ -26,11 +29,14 @@ npx/docker/publish
 ```
 
 The script will:
-- Check if the image exists (builds it if not found)
+- **Always rebuild** the image using Docker buildx (even if a local image exists)
+- Build for both `linux/amd64` and `linux/arm64` architectures
 - Verify Docker Hub login
 - Push both version and `latest` tags to Docker Hub
 
-**Note:** Make sure to run `docker login` before publishing.
+**Note:** The publish script always rebuilds the image to ensure both architectures are built and pushed. Running the build script first is not necessary and won't speed up the publishing process.
+
+**Prerequisites:** Make sure to run `docker login` before publishing.
 
 ### Using the Docker Image
 
@@ -55,4 +61,4 @@ For the `run` subcommand, use `-p 5173:5173` to map the Vite dev server port to
 
 The tool clones the template repository to a temporary directory inside the container, so git operations happen entirely within the container and don't require host filesystem access.
 
-The container automatically passes `--no-open` to prevent browser opening attempts inside the container. When the server starts, you'll see a message with the URL to open in your browser.
+The container automatically passes `--no-open --public` flags to prevent browser opening attempts and bind to 0.0.0.0 (making it accessible from outside the container). When the server starts, you'll see a message with the URL to open in your browser.

npx/docker/build

@@ -26,9 +26,29 @@ if ! docker info > /dev/null 2>&1; then
     exit 1
 fi
 
-# Build the Docker image with version and latest tags
-echo -e "${BLUE}📦 Building Docker image...${NC}"
-docker build -t "${IMAGE_NAME}:${VERSION}" -t "${IMAGE_NAME}:latest" .
+# Check if buildx is available
+if ! docker buildx version > /dev/null 2>&1; then
+    echo -e "${YELLOW}⚠️  Docker buildx not available. Building for current platform only.${NC}"
+    echo -e "${BLUE}📦 Building Docker image...${NC}"
+    docker build -t "${IMAGE_NAME}:${VERSION}" -t "${IMAGE_NAME}:latest" .
+else
+    # Create builder instance if it doesn't exist
+    if ! docker buildx ls | grep -q "claude-artifact-builder"; then
+        echo -e "${BLUE}🔧 Creating buildx builder instance...${NC}"
+        docker buildx create --name claude-artifact-builder --use
+    else
+        docker buildx use claude-artifact-builder
+    fi
+    
+    # Build for multiple architectures
+    echo -e "${BLUE}📦 Building Docker image for amd64 and arm64...${NC}"
+    docker buildx build \
+        --platform linux/amd64,linux/arm64 \
+        --tag "${IMAGE_NAME}:${VERSION}" \
+        --tag "${IMAGE_NAME}:latest" \
+        --load \
+        .
+fi
 
 if [ $? -eq 0 ]; then
     echo -e "${GREEN}✅ Docker image built successfully!${NC}"

npx/docker/publish

@@ -26,19 +26,8 @@ if ! docker info > /dev/null 2>&1; then
     exit 1
 fi
 
-# Check if image exists
-if ! docker images | grep -q "${IMAGE_NAME}.*${VERSION}"; then
-    echo -e "${YELLOW}⚠️  Image ${IMAGE_NAME}:${VERSION} not found.${NC}"
-    echo -e "${BLUE}Building image first...${NC}"
-    echo ""
-    "$(dirname "$0")/build"
-    if [ $? -ne 0 ]; then
-        exit 1
-    fi
-    echo ""
-fi
-
-# Check if user is logged in to Docker Hub
+# Check if Docker Hub credentials exist in config
+# Docker Hub can be stored as "https://index.docker.io/v1/" or "docker.io"
 DOCKER_CONFIG="${HOME}/.docker/config.json"
 
 if [ ! -f "$DOCKER_CONFIG" ]; then
@@ -47,8 +36,6 @@ if [ ! -f "$DOCKER_CONFIG" ]; then
     exit 1
 fi
 
-# Check if Docker Hub credentials exist in config
-# Docker Hub can be stored as "https://index.docker.io/v1/" or "docker.io"
 if ! grep -qE "(https://index\.docker\.io/v1/|docker\.io)" "$DOCKER_CONFIG" 2>/dev/null; then
     echo -e "${YELLOW}⚠️  Not logged in to Docker Hub. Please login first:${NC}"
     echo -e "  docker login"
@@ -60,18 +47,40 @@ echo -e "${BLUE}✓ Docker Hub login detected${NC}"
 read -p "Make sure you are logged in as claudiombsilva and press Enter to continue: "
 echo ""
 
-# Push the image
-echo -e "${BLUE}📤 Pushing Docker image to Docker Hub...${NC}"
-docker push "${IMAGE_NAME}:${VERSION}"
-docker push "${IMAGE_NAME}:latest"
+# Check if buildx is available (required for multi-architecture builds)
+if ! docker buildx version > /dev/null 2>&1; then
+    echo -e "${YELLOW}⚠️  Docker buildx not available. Cannot build multi-architecture images.${NC}"
+    echo -e "${YELLOW}   Please install Docker buildx or use Docker Desktop.${NC}"
+    exit 1
+fi
+
+# Set up buildx builder for multi-architecture builds
+echo -e "${BLUE}🔧 Setting up buildx builder...${NC}"
+if ! docker buildx ls | grep -q "claude-artifact-builder"; then
+    docker buildx create --name claude-artifact-builder --use
+else
+    docker buildx use claude-artifact-builder
+fi
+
+# Build and push multi-architecture images
+# Note: We always rebuild here to ensure both architectures are built and pushed
+echo -e "${BLUE}📦 Building and pushing Docker images for amd64 and arm64...${NC}"
+docker buildx build \
+    --platform linux/amd64,linux/arm64 \
+    --tag "${IMAGE_NAME}:${VERSION}" \
+    --tag "${IMAGE_NAME}:latest" \
+    --push \
+    .
 
 if [ $? -eq 0 ]; then
-    echo -e "${GREEN}✅ Successfully published to Docker Hub!${NC}"
+    echo ""
+    echo -e "${GREEN}✅ Successfully published multi-architecture images to Docker Hub!${NC}"
+    echo -e "${GREEN}   Platforms: linux/amd64, linux/arm64${NC}"
     echo ""
     echo -e "${BLUE}Usage:${NC}"
-    echo -e "  docker run --rm -v \$(pwd):/w -w /w ${IMAGE_NAME} <artifact-file.tsx>"
+    echo -e "  docker run --rm -p 5173:5173 -v \$(pwd):/w -w /w ${IMAGE_NAME} <artifact-file.tsx>"
 else
-    echo -e "${YELLOW}❌ Failed to push to Docker Hub.${NC}"
+    echo -e "${YELLOW}❌ Build and push failed.${NC}"
     exit 1
 fi
 

npx/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run-claude-artifact",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Run Claude AI Artifacts locally - quick preview, or create projects, build, deploy, and push to a Git repository.",
   "bin": {
     "run-claude-artifact": "./run-claude-artifact.js"

npx/run-claude-artifact.js

@@ -70,7 +70,8 @@ async function parseArgs() {
     projectDir: null, // For create subcommand
     remote: null, // For create subcommand
     push: false, // For create subcommand
-    noOpen: false // Don't open browser automatically
+    noOpen: false, // Don't open browser automatically
+    public: false // Bind to 0.0.0.0 instead of localhost (useful for Docker)
   };
 
   // Handle help request
@@ -107,6 +108,7 @@ Options by Subcommand:
   Global Options:
     -h, --help           Show this help message
     --no-open            Don't open browser automatically (useful for Docker/CI)
+    --public             Bind to 0.0.0.0 instead of localhost (useful for Docker)
 
 Examples:
   # Run Artifact (Default)
@@ -216,6 +218,8 @@ Notes:
       options.push = true;
     } else if (arg === '--no-open') {
       options.noOpen = true;
+    } else if (arg === '--public') {
+      options.public = true;
     } else {
       console.error(`❌ Unknown option: ${arg}`);
       process.exit(1);
@@ -469,6 +473,9 @@ async function main() {
         if (!options.noOpen) {
           viteArgs.push('--open');
         }
+        if (options.public) {
+          viteArgs.push('--host');
+        }
         const runProcess = spawn('node_modules/.bin/vite', viteArgs, {
           cwd: repoDir,
           stdio: 'inherit'
@@ -480,7 +487,7 @@ async function main() {
           if (options.noOpen) {
             console.log(`🌐 Open your browser at: http://localhost:5173/`);
           }
-        }, 5000);
+        }, 2500);
 
         let signalHandled = false;
         const handleRunSignal = (signal) => {
@@ -516,6 +523,9 @@ async function main() {
         if (!options.noOpen) {
           viteArgs.push('--open');
         }
+        if (options.public) {
+          viteArgs.push('--host');
+        }
         const runProcess = spawn('node_modules/.bin/vite', viteArgs, {
           cwd: repoDir,
           stdio: 'inherit'
@@ -527,7 +537,7 @@ async function main() {
           if (options.noOpen) {
             console.log(`🌐 Open your browser at: http://localhost:5173/`);
           }
-        }, 5000);
+        }, 2500);
 
         let signalHandled = false;
         const handleRunSignal = (signal) => {