logo
Forge
Overview
Initializing search
    • Forge
    • Guides
    • Reference
    • Roadmap
    • Release Notes
    • Foundry
    • ADRs
    • About
    • Contributing
    • Forge
    • Guides
      • Your First Forge Application
      • Development
        • Aspire Publish
        • Aspire Troubleshooting
        • Blue-Green Deployments
        • Downstream API Calls
        • Custom Subdomains
        • Feature Flags
        • SAIF CLI Installation
        • Pipeline Troubleshooting
        • Settings and Secrets
        • TypeSpec Contracts
        • TypeSpec API Design
          • Cosmos DB NoSQL
          • Oracle Database
          • Blob Storage
          • Event Service
          • Event Subscriptions
          • WireMock Hosting
          • WireMock Runner Hosting
          • WireMock Recording
          • API Testing with Aspire
          • Integration Test Environment Variables
          • Web Testing with Playwright
        • Webhooks
          • Filevine Webhook Integration
      • Migration
        • Forge v1 to v2
        • Forge v2 to v3
        • Test Tools Migration (Forge v2 to v3)
        • MCP-Assisted Migration to Forge v3
      • Security
          • App Permissions
          • Aspire Security Configuration
          • Business Roles
          • Deployment Workflow
          • Subscription Key Authentication
          • User Permissions
          • JWT Test Tokens
          • Test Tools Repository
          • External Test Users
          • Non-Production Roles
    • Reference
      • Authorization
      • Environments
      • Version Compatibility Matrix
      • Architecture
        • Golden Path
      • Diagnostics
        • SAIFENV001: SAIF Environment API is Experimental
        • SAIFMOCK001: WireMock Runner API is Experimental
        • SAIFSECURITY001: Security Configuration API is Experimental
      • Tools
        • Aspire
        • Azure
        • Azure DevOps Services
        • Docker Desktop
        • Dynatrace
        • Entity Framework
        • Kiota
        • OpenTelemetry
        • Project Templates
        • SAIF CLI
        • Terraform
        • Terraform Cloud
        • TypeSpec
        • WireMock
    • Roadmap
    • Release Notes
      • 3.4.0
      • 3.3.0
      • 3.2.7
      • 3.2.6
      • 3.2.5
      • 3.2.4
      • 3.2.3
      • 3.2.2
      • 3.2.1
      • 3.2.0
      • 3.1.3
      • 3.1.2
      • 3.1.1
      • 3.1.0
      • 3.0.14
      • 3.0.13
      • 3.0.12
      • 3.0.11
      • 3.0.10
      • 3.0.9
      • 3.0.8
      • 3.0.7
      • 3.0.6
      • 3.0.5
      • 3.0.4
      • 3.0.3
      • 3.0.2
      • 3.0.1
      • 3.0.0
      • 2.1.25
      • 2.1.24
      • 2.1.23
      • 2.1.22
      • 2.1.21
      • 2.1.20
      • 2.1.19
      • 2.1.18
      • 2.1.17
      • 2.1.16
    • Foundry
        • Blob Storage Integration
        • Aspire Configuration Example
        • Playwright Integration Testing
        • WireMock CLI Example
        • WireMock Runner Example
        • DevTunnels Webhook Example
        • Event Orchestration Example
        • Events with Cosmos DB Example
        • APIM Policy Example
    • ADRs
      • Use Markdown Architectural Decision Records
      • Terraform State and Module Management
      • All API Endpoints Require Authentication
      • All Non-Api Management Azure Resources Will Have Private Endpoints
      • Preferred Method of Deployment of APIs
      • Subdomain Names of Applications and APIs
      • Okta Multi-Tenant Architecture
      • Observability and Monitoring
      • Terraform Linting
      • On-Premise Authentication to Forge Applications
      • Feature Flag Provider Selection
    • About
      • Platform Overview
      • History
      • Principles
    • Contributing
      • GitHub Copilot Skills
      • Design System
      • Forge Monorepo
      • SAIF DotNet CLI Project Templates
      • Release Process
      • MSBuild Reference Swapping
      • Terraform Module Swapping
      • Local Terraform Testing
      • Terraform Repository Inventory
      • Package Config Updates

    Architectural Decision Records¶

    Architectural Decision Records (ADRs) capture significant technical and architectural choices made for this platform. Use this section to browse past decisions, understand their context, and ensure new work aligns with established direction.

    • 0000-use-markdown-architectural-decision-records
    • 0001-terraform-state-and-module-management
    • 0002-all-api-endpoints-require-authentication
    • 0003-all-non-api-management-azure-resources-will-have-private-endpoints
    • 0004-preferred-method-of-deployment-of-apis
    • 0005-subdomain-names-of-applications-and-apis
    • 0006-okta-multi-tenant-architecture
    • 0007-observability-and-monitoring
    • 0008-terraform-linting
    • 0009-on-premise-authentication-to-forge
    • 0010-feature-flag-provider-selection
    May 6, 2026
    Made with Material for MkDocs