cloudflare-images:validate-config

Validate Cloudflare Images Configuration

Comprehensive validation of wrangler.jsonc, environment variables, and Cloudflare Images bindings for Workers integration.

What This Command Does

When you run /validate-config, Claude will:

1. Check if wrangler.jsonc exists and has valid JSON
2. Verify images binding configuration
3. Validate environment variables (.env, .dev.vars)
4. Test API token permissions
5. Check account ID matches binding
6. Verify Worker can access IMAGES binding
7. Validate transformation endpoints
8. Check for common configuration issues

Usage

/validate-config

Run from your Cloudflare Worker project root (where wrangler.jsonc is located).

Implementation

Run the following validation checks:

1. Check wrangler.jsonc Exists

echo "📁 Checking project structure..."

if [ ! -f "wrangler.jsonc" ]; then
  echo "❌ wrangler.jsonc not found"
  echo "   Run: wrangler init"
  exit 1
else
  echo "✅ wrangler.jsonc found"
fi

echo ""

2. Validate wrangler.jsonc Syntax

echo "📝 Validating wrangler.jsonc syntax..."

# Check if valid JSON (with comments allowed for JSONC)
if jq empty wrangler.jsonc 2>/dev/null; then
  echo "✅ Valid JSON syntax"
else
  # Try stripping comments and validating
  if grep -v '^\s*//' wrangler.jsonc | jq empty 2>/dev/null; then
    echo "✅ Valid JSONC syntax (with comments)"
  else
    echo "❌ Invalid JSON syntax in wrangler.jsonc"
    echo "   Check for trailing commas, missing quotes, etc."
    exit 1
  fi
fi

echo ""

3. Verify Images Binding Configuration

echo "🔗 Checking images binding..."

BINDING_EXISTS=$(jq -r 'has("images")' wrangler.jsonc 2>/dev/null)

if [ "$BINDING_EXISTS" = "true" ]; then
  echo "✅ images binding configured"

  # Validate binding structure
  BINDING_COUNT=$(jq -r '.images | length' wrangler.jsonc)
  echo "   Bindings configured: $BINDING_COUNT"

  # Check each binding
  for i in $(seq 0 $(($BINDING_COUNT - 1))); do
    BINDING_NAME=$(jq -r ".images[$i].binding" wrangler.jsonc)
    BINDING_ACCOUNT=$(jq -r ".images[$i].account_id" wrangler.jsonc)

    if [ "$BINDING_NAME" != "null" ]; then
      echo "   • Binding: $BINDING_NAME"
    else
      echo "   ⚠️  Binding $i missing 'binding' field (default: IMAGES)"
    fi

    if [ "$BINDING_ACCOUNT" != "null" ]; then
      echo "     Account: ${BINDING_ACCOUNT:0:8}..."
    else
      echo "     ⚠️  No account_id specified (will use account from wrangler auth)"
    fi
  done
else
  echo "❌ No images binding configured"
  echo ""
  echo "   Add to wrangler.jsonc:"
  echo '   {
     "images": [
       {
         "binding": "IMAGES",
         "account_id": "your_account_id"
       }
     ]
   }'
  exit 1
fi

echo ""