🛍️ Add BigCommerce Theme Deployment Workflow

[TheOrangePuff]

Summary

• Comprehensive BigCommerce Stencil theme deployment workflow with CI/CD integration
• Multi-environment support for staging and production deployments
• Streamlined deployment process with modern package manager support

Features

🎯 Stencil CLI Integration: Complete theme bundling, validation, and deployment pipeline
🌍 Multi-Environment: Staging and production deployment workflows
✅ Theme Validation: Bundle size checks, file permissions, and configuration validation
📦 Package Manager Support: Full support for npm, yarn, and pnpm with automatic detection
🔧 Node.js Version Management: Automatic .nvmrc file detection with fallback support
📋 Version Management: Theme versioning and deployment tracking
🔧 Configuration: Environment templating and custom theme configuration support
🚀 Channel Management: Multi-channel deployment with activation control
🐛 Debug Support: Verbose logging and comprehensive error reporting

Key Improvements

• ✅ Implemented all TODO comments: Modernized Node.js version handling and package manager support
• ✅ Smart Node.js detection: Uses .nvmrc files automatically with input fallback
• ✅ Full pnpm support: Added alongside existing npm and yarn support
• ✅ Simplified workflow: Removed unnecessary backup and optimization complexity
• ✅ Updated documentation: Comprehensive README with accurate examples

Usage Examples

Basic Staging Deployment

jobs:
  deploy-staging:
    uses: aligent/workflows/.github/workflows/bigcommerce-theme-deploy.yml@main
    with:
      store-hash: "abc123def4"
      environment: staging
      theme-name: "my-storefront-theme"
    secrets:
      bigcommerce-access-token: ${{ secrets.BIGCOMMERCE_ACCESS_TOKEN }}
      bigcommerce-client-id: ${{ secrets.BIGCOMMERCE_CLIENT_ID }}
      bigcommerce-client-secret: ${{ secrets.BIGCOMMERCE_CLIENT_SECRET }}

Production with Multi-Channel

jobs:
  deploy-production:
    uses: aligent/workflows/.github/workflows/bigcommerce-theme-deploy.yml@main
    with:
      store-hash: "xyz789abc1"
      environment: production
      theme-name: "production-theme"
      apply-to-all-channels: true
      activate-theme: true
    secrets:
      bigcommerce-access-token: ${{ secrets.BIGCOMMERCE_ACCESS_TOKEN }}
      bigcommerce-client-id: ${{ secrets.BIGCOMMERCE_CLIENT_ID }}
      bigcommerce-client-secret: ${{ secrets.BIGCOMMERCE_CLIENT_SECRET }}

🛍️ Generated with Claude Code