Changelog

All notable changes to SCF will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.0.2] - 2025-11-28

Fixed

  • Free Plan Compatibility: Fixed error when updating distributions on Free pricing plan
  • priceClass update is now automatically skipped for Free plan distributions
  • Free plan uses all edge locations (equivalent to PriceClass_All)

[2.0.1] - 2025-11-28

Fixed

  • Fixed remaining TTL references in Zod schema and config utilities
  • Updated test cases to remove TTL validation tests

Changed

  • Enhanced README with v2.0.0 changelog details

[2.0.0] - 2025-11-28

Breaking Changes

  • TTL Settings Removed: defaultTTL, maxTTL, minTTL options have been removed from CloudFront configuration
  • AWS Managed Cache Policy: CloudFront now uses CachingOptimized managed cache policy instead of legacy ForwardedValues

Added

  • Automatic cache management via AWS Managed Cache Policy (CachingOptimized)
  • Pricing plan recommendation message after new CloudFront distribution creation

Changed

  • CloudFront distributions now use CachePolicyId for cache management
  • Improved CloudFront distribution creation with modern AWS best practices

Migration Guide

If you're upgrading from v1.x, remove TTL fields from your scf.config.ts:

typescript
// Before (v1.x) - These options are no longer supported
cloudfront: {
  enabled: true,
  defaultTTL: 3600,     // ❌ Remove
  maxTTL: 86400,        // ❌ Remove
  minTTL: 0,            // ❌ Remove
}

// After (v2.0.0)
cloudfront: {
  enabled: true,
  // TTL is now managed automatically by AWS
}

Note: If you keep TTL settings in your config, they will be ignored in v2.0.0+.


[1.1.0] - 2025-11-26

Added

  • SPA Mode: CloudFront SPA (Single Page Application) mode enabled by default
    • Added cloudfront.spa option (default: true)
    • Automatically redirects 403/404 errors to index.html
    • Supports client-side routing (React Router, Vue Router, etc.)

Changed

  • Improved CloudFront custom error response management logic
  • Enhanced error messages with regex pattern matching in tests

[1.0.0] - 2025-11-20

🎉 First Stable Release

SCF is now production-ready! This release includes comprehensive testing, CI/CD integration, and enhanced AWS resource management.

Added

  • CI/CD Integration: GitHub Actions workflows for main branch and PR checks
  • Comprehensive Testing: Unit, Integration, and E2E test suites
  • E2E Tests: Full coverage for ACM certificate and Route53 resource management
  • Enhanced State Management: Improved CloudFront deployment with ACM and Route53 state tracking
  • Subdomain Support: Enhanced hosted zone validation for subdomain configurations
  • CODE_OF_CONDUCT.md: Community guidelines for contributors
  • CONTRIBUTING.md: Detailed contribution guidelines

Changed

  • Improved S3 bucket name generation algorithm
  • Enhanced error messages with regex pattern matching in tests
  • Production-ready stability improvements

Infrastructure

  • E2E testing infrastructure for AWS resources
  • Automated CI pipeline for code quality checks
  • Pre-push hooks with Husky for development workflow

[0.6.0] - 2025-11-18

Added

  • Environment variable management with .env files support
  • Load and manage environment-specific variables during deployment

Changed

  • Standardize import statements and improve code consistency

[0.5.0] - 2025-11-07

Added

  • Automatic SSL certificate creation for custom domains
  • Auto-creation of Route53 hosted zones in validation process
  • DNS alias record creation for CloudFront distributions
  • Resource recovery process with discovery and tagging capabilities
  • Enhanced remove command for complete AWS resource deletion
  • Husky integration for pre-push checks
  • Enhanced ESLint configuration

Changed

  • Streamline error handling and improve code clarity in CLI commands
  • Update README with enhanced features and improved configuration details

Fixed

  • Update unit tests for Route53Manager to use matchObject for hosted zone responses
  • Update S3 config validation to allow auto-detection of build directory
  • Add defineConfig helper function for type-safe configuration

[0.4.1] - 2025-11-03

Changed

  • Version bump release

[0.4.0] - 2025-11-03

Added

  • CloudFront cache warming feature to improve deployment performance
  • Enhanced init command with type safety for configuration

Changed

  • Remove unused defineConfig function from config.ts
  • Enhanced README with improved configuration details

[0.3.0] - 2025-10-30

Added

  • Jest testing framework and initial test configurations
  • Auto-build feature for deployment process
  • Recovery features for failed deployments
  • SCF configuration file support
  • Enhanced post-install script

Changed

  • Remove version declaration from CLI program
  • Remove outdated documentation files
  • Enhanced README with new features and build process improvements

[0.2.0] - 2025-10-25

Added

  • init command for project initialization
  • Renamed CLI command for better usability

Changed

  • Update version to 0.1.0 and rename CLI command

[0.1.2] - 2025-10-20

Changed

  • Version bump release

[0.1.1] - 2025-10-18

Changed

  • Rename project to scf-deploy
  • Update documentation to reflect new project name

Removed

  • Outdated DEPLOYMENT_GUIDE.md file

[0.1.0] - 2025-10-15

Added

  • Initial release of SCF
  • S3 bucket deployment with incremental upload
  • CloudFront distribution management
  • Cache invalidation support
  • State management for deployment tracking
  • AWS credentials integration
  • TypeScript configuration with Zod validation
  • CLI commands: deploy, remove, status
  • ESLint configuration
  • Comprehensive deployment guide

Versioning

  • Major version (X.0.0): Breaking changes
  • Minor version (0.X.0): New features (backwards compatible)
  • Patch version (0.0.X): Bug fixes

Release Notes

For detailed release notes, see GitHub Releases.

Future Roadmap

  • Advanced caching strategies
  • Lambda@Edge support
  • Enhanced monitoring
  • Performance analytics
  • Cost optimization features

Support

For questions about specific versions, see:

5 min readLast updated: 2025-11-28