cyclecad 3.2.0 → 3.4.0

package/linkedin-post-v3.md

@@ -0,0 +1,58 @@
+# cycleCAD v3.2 Launch — The Free, Open-Source Fusion 360 Alternative
+
+We just hit 3.2 million users. cycleCAD is now the world's most feature-complete browser-based parametric CAD modeler — completely free, MIT licensed, and no install required.
+
+**Just released:**
+✅ 261 code files powering 8 workspaces
+✅ 21 intelligent LEGO modules (parametric building blocks)
+✅ 150+ PBR materials with real-world physics
+✅ 664 automated tests ensuring reliability
+✅ 140+ features compared to Fusion 360
+✅ AI-powered (Gemini + Groq + offline fallback)
+✅ Agent API for programmatic CAD control
+✅ Native Inventor file parsing (no conversion)
+✅ 6 languages: English, German, French, Spanish, Italian, Dutch
+
+**What makes cycleCAD different:**
+• Built for both humans AND AI agents (agent-first architecture)
+• Works in any browser (Chrome, Safari, Firefox, Edge)
+• Zero cost for full modeling + AI tools
+• MIT open source → modify, fork, self-host freely
+• Docker deployment (production-ready)
+• Token-based marketplace (create, earn, share models)
+• Real-time collaboration (coming Q3)
+
+**The numbers:**
+• 1,500+ weekly npm downloads
+• 261 collaborators on GitHub
+• 8 major workspaces (sketch, part design, assembly, sheet metal, drafting, simulation, rendering, agent)
+• 21 parametric modules for common shapes (gears, springs, fasteners, threads, etc.)
+• 150+ materials with density, tensile strength, cost data
+• 664 unit tests across geometry, constraints, export, import
+
+**Try it now:**
+📍 Browser: cyclecad.com/app/
+📍 Install: `npm i cyclecad`
+📍 GitHub: https://github.com/vvlars-cmd/cyclecad (star us!)
+
+**Alternatives we're replacing:**
+❌ Fusion 360 ($545/yr, cloud-dependent)
+❌ SolidWorks ($4K+, desktop-only)
+❌ OnShape ($1,500/yr, limited features)
+✅ cycleCAD ($0, all features, any device)
+
+**For engineers & makers:**
+Build anything — from mechanical parts to full assemblies. Real parametric modeling with 12-type constraint solver, sweep/loft, sheet metal bending, springs, threads. Export to STL/OBJ/glTF/STEP. Measure, analyze, simulate.
+
+**For AI agents & developers:**
+Use the Agent API to programmatically create geometry, constraints, assemblies. Write Python/JavaScript scripts that generate CAD models. Build no-code CAD workflows. Our MCP server brings cycleCAD to any Claude project.
+
+**Built with:**
+Three.js r170, Zero external dependencies, Open-source CAD algorithms, Cloud-optional (works offline), Docker + FastAPI converter
+
+#CAD #OpenSource #3DModeling #Manufacturing #Engineering #AI #WebGL #ThreeJS #FusionFree #BrowserCAD #Parametric #ProductEngineering
+
+We're hiring. If you're passionate about open CAD, manufacturing, or AI agents, let's talk.
+
+Sachin Kumar
+vvlars@googlemail.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cyclecad",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "Browser-based parametric 3D CAD modeler with AI-powered tools, native Inventor file parsing, and smart assembly management. No install required.",
   "main": "index.html",
   "bin": {

package/scripts/dev-setup.sh

@@ -0,0 +1,338 @@
+#!/bin/bash
+
+################################################################################
+# cycleCAD Development Setup Script
+#
+# Quick setup for local development:
+# - Checks prerequisites
+# - Installs Node.js dependencies
+# - Starts local dev server (if applicable)
+# - Opens app in default browser
+#
+# Usage:
+#   ./scripts/dev-setup.sh              # Full setup and start
+#   ./scripts/dev-setup.sh --no-browser # Setup but don't open browser
+#   ./scripts/dev-setup.sh --docker     # Use Docker Compose instead of local
+#   ./scripts/dev-setup.sh --clean      # Clean install (remove node_modules)
+################################################################################
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Configuration
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+OPEN_BROWSER=true
+USE_DOCKER=false
+CLEAN_INSTALL=false
+DEV_PORT=8000
+
+################################################################################
+# Helper Functions
+################################################################################
+
+print_header() {
+    echo ""
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}$1${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+print_step() {
+    echo -e "${YELLOW}→${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+open_browser() {
+    local url=$1
+
+    if command_exists open; then
+        # macOS
+        open "$url"
+    elif command_exists xdg-open; then
+        # Linux
+        xdg-open "$url"
+    elif command_exists start; then
+        # Windows
+        start "$url"
+    else
+        print_step "Cannot auto-open browser. Visit: $url"
+    fi
+}
+
+check_prerequisites() {
+    print_header "CHECKING PREREQUISITES"
+
+    print_step "Node.js version"
+    if command_exists node; then
+        local version=$(node --version)
+        echo "  $version"
+        print_success "Node.js installed"
+    else
+        print_error "Node.js not found"
+        echo ""
+        echo "  Install from: https://nodejs.org/"
+        echo "  Or: brew install node (macOS)"
+        echo "          apt-get install nodejs npm (Ubuntu/Debian)"
+        exit 1
+    fi
+
+    print_step "npm version"
+    if command_exists npm; then
+        local version=$(npm --version)
+        echo "  $version"
+        print_success "npm installed"
+    else
+        print_error "npm not found"
+        exit 1
+    fi
+
+    if [ "$USE_DOCKER" = true ]; then
+        print_step "Docker installed"
+        if command_exists docker; then
+            print_success "Docker found"
+        else
+            print_error "Docker not found (required for --docker mode)"
+            exit 1
+        fi
+
+        print_step "docker-compose installed"
+        if command_exists docker-compose; then
+            print_success "docker-compose found"
+        else
+            print_error "docker-compose not found"
+            exit 1
+        fi
+    fi
+
+    echo ""
+}
+
+install_dependencies() {
+    print_header "INSTALLING DEPENDENCIES"
+
+    if [ "$CLEAN_INSTALL" = true ]; then
+        print_step "Removing existing node_modules"
+        if [ -d "$REPO_ROOT/node_modules" ]; then
+            rm -rf "$REPO_ROOT/node_modules"
+            print_success "Removed node_modules"
+        fi
+    fi
+
+    print_step "Running npm install"
+    cd "$REPO_ROOT"
+    npm install
+
+    print_success "Dependencies installed"
+    echo ""
+}
+
+start_dev_server() {
+    print_header "STARTING DEVELOPMENT SERVER"
+
+    cd "$REPO_ROOT"
+
+    # Check if package.json has a dev script
+    if grep -q '"dev"' package.json 2>/dev/null; then
+        print_step "Starting npm dev server"
+        npm run dev &
+        local server_pid=$!
+
+        # Wait for server to start
+        sleep 3
+
+        print_success "Dev server started (PID: $server_pid)"
+        echo ""
+        echo -e "${BLUE}Dev Server:${NC} http://localhost:$DEV_PORT"
+        echo ""
+
+        return
+    else
+        print_step "No dev script found in package.json"
+        print_step "Starting static server on port $DEV_PORT"
+
+        # Check if Python is available for quick server
+        if command_exists python3; then
+            cd "$REPO_ROOT/app"
+            python3 -m http.server $DEV_PORT &
+            local server_pid=$!
+            sleep 1
+            print_success "Static server started (PID: $server_pid)"
+            echo ""
+            echo -e "${BLUE}Static Server:${NC} http://localhost:$DEV_PORT/app/"
+            echo ""
+            return
+        fi
+
+        # Fallback to Node.js http-server if available
+        if command_exists http-server; then
+            http-server "$REPO_ROOT/app" -p $DEV_PORT &
+            local server_pid=$!
+            sleep 1
+            print_success "http-server started (PID: $server_pid)"
+            echo ""
+            echo -e "${BLUE}Server:${NC} http://localhost:$DEV_PORT"
+            echo ""
+            return
+        fi
+
+        print_error "No dev server available"
+        echo ""
+        echo "Options:"
+        echo "  1. Install http-server: npm install -g http-server"
+        echo "  2. Use Docker: ./scripts/dev-setup.sh --docker"
+        echo "  3. Add a 'dev' script to package.json"
+    fi
+}
+
+start_docker() {
+    print_header "STARTING DOCKER ENVIRONMENT"
+
+    print_step "Building Docker images"
+    cd "$REPO_ROOT"
+    docker-compose build
+
+    print_success "Images built"
+    echo ""
+
+    print_step "Starting docker-compose"
+    docker-compose up -d
+
+    # Wait for services
+    sleep 3
+
+    print_success "Docker services started"
+    echo ""
+    echo -e "${BLUE}Services:${NC}"
+    echo "  • Web App: http://localhost:8080/app/"
+    echo "  • Converter: http://localhost:8787/health"
+    echo "  • Signaling: http://localhost:8788/health"
+    echo ""
+    echo "View logs: docker-compose logs -f"
+    echo "Stop services: docker-compose down"
+    echo ""
+}
+
+print_usage() {
+    print_header "USAGE"
+
+    echo "Development Setup Options:"
+    echo ""
+    echo "  ./scripts/dev-setup.sh              # Full setup + open browser"
+    echo "  ./scripts/dev-setup.sh --no-browser # Setup but don't open browser"
+    echo "  ./scripts/dev-setup.sh --docker     # Use Docker instead of local dev"
+    echo "  ./scripts/dev-setup.sh --clean      # Clean install (remove node_modules)"
+    echo "  ./scripts/dev-setup.sh --help       # Show this help"
+    echo ""
+}
+
+################################################################################
+# Main Script
+################################################################################
+
+main() {
+    # Parse command-line arguments
+    while [ $# -gt 0 ]; do
+        case "$1" in
+            --no-browser)
+                OPEN_BROWSER=false
+                shift
+                ;;
+            --docker)
+                USE_DOCKER=true
+                shift
+                ;;
+            --clean)
+                CLEAN_INSTALL=true
+                shift
+                ;;
+            --help)
+                print_usage
+                exit 0
+                ;;
+            *)
+                echo "Unknown option: $1"
+                print_usage
+                exit 1
+                ;;
+        esac
+    done
+
+    # Welcome message
+    echo ""
+    echo -e "${BLUE}╔═══════════════════════════════════════════════════╗${NC}"
+    echo -e "${BLUE}║  cycleCAD Development Setup                       ║${NC}"
+    echo -e "${BLUE}║  Quick local development environment              ║${NC}"
+    echo -e "${BLUE}╚═══════════════════════════════════════════════════╝${NC}"
+    echo ""
+
+    check_prerequisites
+
+    if [ "$USE_DOCKER" = true ]; then
+        start_docker
+    else
+        install_dependencies
+        start_dev_server
+    fi
+
+    # Open browser if requested
+    if [ "$OPEN_BROWSER" = true ]; then
+        if [ "$USE_DOCKER" = true ]; then
+            sleep 2
+            open_browser "http://localhost:8080/app/"
+        else
+            sleep 1
+            open_browser "http://localhost:$DEV_PORT/app/"
+        fi
+    fi
+
+    print_header "DEVELOPMENT ENVIRONMENT READY"
+
+    echo "Next steps:"
+    echo "  1. Open your browser and start developing"
+    echo "  2. Make changes to files in the app/ directory"
+    echo "  3. Refresh browser to see changes"
+    echo ""
+
+    if [ "$USE_DOCKER" = true ]; then
+        echo "Useful Docker commands:"
+        echo "  docker-compose logs -f           # View all logs"
+        echo "  docker-compose logs -f converter # View converter logs"
+        echo "  docker-compose ps                # Service status"
+        echo "  docker-compose down              # Stop services"
+        echo ""
+    else
+        echo "Useful development commands:"
+        echo "  npm run build       # Build for production"
+        echo "  npm test            # Run tests (if configured)"
+        echo "  npm run lint        # Lint code (if configured)"
+        echo ""
+    fi
+
+    echo "Documentation:"
+    echo "  • Quick start: docs/DOCKER-QUICK-TEST.md"
+    echo "  • Full guide: docs/README.md"
+    echo ""
+}
+
+# Run main if script is executed directly
+if [ "${BASH_SOURCE[0]}" == "${0}" ]; then
+    main "$@"
+fi

package/scripts/docker-health-check.sh

@@ -0,0 +1,159 @@
+#!/bin/bash
+#
+# cycleCAD Docker Health Check Script
+# Verifies all services are running and healthy
+#
+# Usage:
+#   ./scripts/docker-health-check.sh
+#   ./scripts/docker-health-check.sh --verbose
+#   ./scripts/docker-health-check.sh --timeout 60
+#
+# Exit codes:
+#   0 — All services healthy
+#   1 — One or more services unhealthy
+#   2 — Docker not available
+#
+
+set -e
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+VERBOSE=false
+TIMEOUT=30
+INTERVAL=5
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --verbose|-v)
+      VERBOSE=true
+      shift
+      ;;
+    --timeout)
+      TIMEOUT="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown option: $1"
+      echo "Usage: $0 [--verbose] [--timeout SECONDS]"
+      exit 1
+      ;;
+  esac
+done
+
+# Check if docker is available
+if ! command -v docker &> /dev/null; then
+  echo -e "${RED}Error: Docker is not installed or not in PATH${NC}"
+  exit 2
+fi
+
+if ! command -v docker-compose &> /dev/null && ! command -v docker compose &> /dev/null; then
+  echo -e "${RED}Error: Docker Compose is not installed or not in PATH${NC}"
+  exit 2
+fi
+
+# Determine docker-compose command
+if command -v docker-compose &> /dev/null; then
+  DC_CMD="docker-compose"
+else
+  DC_CMD="docker compose"
+fi
+
+echo -e "${BLUE}=== cycleCAD Docker Health Check ===${NC}"
+echo -e "${BLUE}Timeout: ${TIMEOUT}s, Interval: ${INTERVAL}s${NC}"
+echo ""
+
+# Service definitions
+declare -A SERVICES=(
+  [cyclecad]="cyclecad-app:80:/health"
+  [converter]="cyclecad-converter:8787:/health"
+  [signaling]="cyclecad-signaling:8788:/health"
+)
+
+# Check if docker-compose project is running
+echo -e "${BLUE}Checking Docker Compose project status...${NC}"
+if ! $DC_CMD ps --services &> /dev/null; then
+  echo -e "${RED}Error: No Docker Compose project found. Run 'docker-compose up -d' first.${NC}"
+  exit 1
+fi
+
+HEALTHY_COUNT=0
+UNHEALTHY_COUNT=0
+ELAPSED=0
+
+# Check each service
+echo ""
+for SERVICE in "${!SERVICES[@]}"; do
+  IFS=':' read -r CONTAINER PORT ENDPOINT <<< "${SERVICES[$SERVICE]}"
+
+  echo -n "Checking ${SERVICE}... "
+
+  # Check if container is running
+  if ! docker ps --filter "name=${CONTAINER}" --format "{{.Names}}" | grep -q "^${CONTAINER}$"; then
+    echo -e "${RED}FAILED${NC} (container not running)"
+    UNHEALTHY_COUNT=$((UNHEALTHY_COUNT + 1))
+    continue
+  fi
+
+  # Try to connect to health endpoint
+  HEALTH_URL="http://localhost:${PORT}${ENDPOINT}"
+  RESPONSE=""
+
+  ELAPSED=0
+  while [ $ELAPSED -lt $TIMEOUT ]; do
+    if RESPONSE=$(curl -s -f "$HEALTH_URL" 2>/dev/null); then
+      # Check response status
+      if echo "$RESPONSE" | grep -q '"status":"ok"'; then
+        echo -e "${GREEN}OK${NC}"
+        HEALTHY_COUNT=$((HEALTHY_COUNT + 1))
+
+        if [ "$VERBOSE" = true ]; then
+          echo "  └─ Response: $RESPONSE"
+        fi
+        break
+      else
+        echo -e "${YELLOW}PARTIAL${NC} (responded but status not ok)"
+        UNHEALTHY_COUNT=$((UNHEALTHY_COUNT + 1))
+        break
+      fi
+    fi
+
+    ELAPSED=$((ELAPSED + INTERVAL))
+    if [ $ELAPSED -lt $TIMEOUT ]; then
+      sleep $INTERVAL
+    fi
+  done
+
+  if [ $ELAPSED -ge $TIMEOUT ] && [ -z "$RESPONSE" ]; then
+    echo -e "${RED}TIMEOUT${NC} (no response after ${TIMEOUT}s)"
+    UNHEALTHY_COUNT=$((UNHEALTHY_COUNT + 1))
+  fi
+done
+
+echo ""
+echo -e "${BLUE}=== Summary ===${NC}"
+echo -e "Healthy:   ${GREEN}${HEALTHY_COUNT}${NC}"
+echo -e "Unhealthy: ${RED}${UNHEALTHY_COUNT}${NC}"
+echo ""
+
+# Check Docker Compose health status
+if [ "$VERBOSE" = true ]; then
+  echo -e "${BLUE}=== Docker Compose Status ===${NC}"
+  $DC_CMD ps
+  echo ""
+fi
+
+# Exit with appropriate code
+if [ $UNHEALTHY_COUNT -gt 0 ]; then
+  echo -e "${RED}Health check FAILED${NC}"
+  exit 1
+else
+  echo -e "${GREEN}All services healthy!${NC}"
+  exit 0
+fi