Skip to content

Development

Guides for building and deploying applications with Forge.

🚀 Getting Started

Guide Description
Installing the SAIF CLI Install and configure the SAIF CLI for project creation and automation
TypeSpec API Contract Development Define API contracts using TypeSpec for OpenAPI generation
TypeSpec API Design Design APIs using TypeSpec patterns and best practices
Settings and Secrets Manage application settings and secrets with App Configuration and Key Vault

💾 Data Storage

Guide Description
Cosmos DB NoSQL Add Azure Cosmos DB NoSQL to your application with Entity Framework
Oracle Database Set up Entity Framework with Oracle Database
Storage Account Integrate Azure Blob Storage for file operations

📡 Eventing & Integration

Guide Description
Event Service Create an APIM API to publish events to Azure Service Bus
Event Subscription Add Service Bus event subscription capabilities to your app
Calling Downstream APIs Configure Kiota clients to call other APIs with proper scopes

🧪 Mocking & Testing

Guide Description
API Integration Testing Test API endpoints using Aspire's DistributedApplicationTestingBuilder
Web Integration Testing Browser-based end-to-end testing with Playwright and Aspire
Integration Test Environment Variables Inject environment variables into integration test runs via the pipeline
Hosting WireMock CLI Configure WireMock hosting in Aspire for local API mocking
Recording API Mocks Record and save API mocks using WireMock CLI and httpyac

🚀 Deployment & Pipelines

Guide Description
Aspire Publish Generate pipeline YAML and infrastructure config from your AppHost
Blue-Green Deployments Configure zero-downtime deployments with manual validation gates

🔍 Troubleshooting

Guide Description
Aspire Troubleshooting Debug Aspire startup issues, resource failures, and errors
Pipeline Troubleshooting Resolve Azure DevOps pipeline errors and build failures