DO-1743: add comprehensive PWA deployment workflow 🚀

[TheOrangePuff]

Summary

🎯 Added a comprehensive Progressive Web Application deployment workflow that transforms how we deploy PWAs to AWS infrastructure

• 📦 Multi-environment deployments - Support for staging, production, and preview environments with proper isolation
• 🌿 Branch-based preview environments - Automatic preview deployments for pull requests with unique URLs
• 🔄 Dual cache strategies - Smart caching with immutable assets (1 year) and revalidated HTML (1 hour)
• ☁️ CloudFront integration - Automatic cache invalidation with configurable paths for instant updates
• 🏷️ Multi-brand deployment support - Parallel deployment matrix for multiple brands in a single workflow
• 📱 Node.js 16-22 compatibility - Flexible package manager support (Yarn/npm) with proper dependency caching
• 🛡️ Manual production gates - Environment-based deployment protection with approval workflows
• 🧹 Artifact optimization - Intelligent cleanup and storage optimization

🎪 Key Features That Make This Awesome

Smart Caching Strategy 🧠
The workflow implements a dual cache approach:

• Static assets (JS/CSS/images) get immutable 1-year caching for lightning-fast loading
• HTML files get 1-hour cache with revalidation to ensure content freshness

Preview Magic ✨
Every PR automatically gets its own preview environment:

• pr-123 or branch-feature-name prefixed deployments
• Unique URLs for stakeholder review
• No collision with production environments

Multi-Brand Matrix Deployment 🎭
Deploy multiple brands in parallel with a single configuration:

brand-config: '{"brand":["brand-a","brand-b","brand-c"]}'

Enterprise-Grade AWS Integration 🏢

• S3 static hosting with proper security headers
• CloudFront CDN for global performance
• Configurable invalidation patterns
• Support for signed URLs (optional)

🚦 Usage Examples

Basic Production Deployment:

uses: aligent/workflows/.github/workflows/pwa-deployment.yml@main
with:
  s3-bucket: my-production-bucket
  cloudfront-distribution-id: E1234567890ABC
  environment: production
  cache-strategy: immutable

PR Preview Environment:

uses: aligent/workflows/.github/workflows/pwa-deployment.yml@main
with:
  s3-bucket: my-preview-bucket
  cloudfront-distribution-id: E1234567890ABC
  environment: preview
  preview-mode: true
  preview-base-url: https://preview.example.com

🔧 What's Under the Hood

4-Stage Pipeline Architecture:

1. 🔍 Prepare - Validates inputs, configures cache strategies, and sets deployment paths
2. 🏗️ Build - Multi-brand matrix builds with dependency caching and test execution
3. 🚀 Deploy - Dual-phase S3 deployment (static assets → HTML) with CloudFront invalidation
4. 🧹 Cleanup - Automatic artifact cleanup to optimize storage costs

Input Validation & Safety:

• Required parameter validation with clear error messages
• Environment type checking (staging/production/preview only)
• Cache strategy validation (immutable/no-cache)
• Debug mode for troubleshooting deployments

Comprehensive Logging:

• Deployment summaries in GitHub job summaries
• Debug mode with verbose AWS CLI output
• CloudFront invalidation tracking
• Build artifact information

This workflow replaces ad-hoc deployment scripts and provides a standardized, battle-tested approach to PWA deployments across all our projects! 🎉

🤖 Generated with Claude Code

Co-Authored-By: Claude [email protected]