Skip to content

Version Compatibility Matrix

Current framework and tool versions supported by Forge platform.

🚀 Upgrading? See Migration Guides

🎯 Version Support

Component Forge 2.1.x Forge 3.0 Breaking?
.NET 8.0, 9.0 10.0 ⚠️ YES
Aspire 9.5.x 13.1 ⚠️ YES
Authentication Okta Okta + Entra ⚠️ YES
Node.js 20.x, 22.x 22.x, 24.x No
TypeScript 5.9+ 5.9+ No
Terraform 1.0+ 1.14+ No

📋 Framework Details

.NET

Version Type Forge 2.1.x Forge 3.0 Support Ends
.NET 8.0 LTS ✅ ❌ Nov 2026
.NET 9.0 STS ✅ ❌ May 2026
.NET 10.0 LTS ❌ ✅ Nov 2027

Configuration:

<TargetFramework>net10.0</TargetFramework>

Node.js

Version Forge 2.1.x Forge 3.0 Support Ends
20.x LTS ✅ ❌ Apr 2026
22.x LTS ✅ ✅ Apr 2027
24.x ❌ ✅ Oct 2027

Aspire

Version Forge 2.1.x Forge 3.0
9.5.x ✅ ❌
13.1 ❌ ✅

Terraform

Version Forge 2.1.x Forge 3.0
1.x ✅ ✅

Required Version Constraint:

required_version = ">= 1.0.0, < 2.0.0"

Terraform Providers

Provider Forge 2.1.x Forge 3.0 Notes
AzureRM >= 4.0, < 5.0 >= 4.0, < 5.0 Azure Resource Manager
AzureAD >= 3.0, < 4.0 >= 3.0, < 4.0 Entra ID (Azure AD)
Okta >= 4.10.0, < 5.0 >= 4.10.0, < 5.0 External tenant only in Forge 3.0
TFE >= 0.58.1, < 1.0 >= 0.58.1, < 1.0 Terraform Cloud/Enterprise
Random >= 3.0, < 4.0 >= 3.0, < 4.0 Random resource generation
Time >= 0.40.0 >= 0.40.0 Time-based resources

Standard Provider Configuration:

terraform {
  required_version = ">= 1.0.0, < 2.0.0"
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = ">= 4.0, < 5.0"
    }
    azuread = {
      source  = "hashicorp/azuread"
      version = ">= 3.0, < 4.0"
    }
  }
}

TypeSpec

Version Forge 2.1.x and below Forge 3.0 Notes
1.3.0+ ✅ Required ✅ Required Compiler minimum
Libraries 0.75.0 - 1.5.0 TBD Various library versions

Key Packages:

{
  "@typespec/compiler": "^1.3.0",
  "@typespec/http": "1.5.0",
  "@typespec/openapi3": "1.5.0"
}

📚 Migration Guides

📚 Resources

Documentation:

Last Updated: December 20, 2025