ADR-0001: .NET 10 as the backend platform

• Status: Accepted
• Date: 2026-01-01
• Deciders: Enterprise Architect, Solution Architect
• Tags: backend, runtime, platform

Context

The factory and every service it generates need a single, modern, long-term-supported backend runtime. Earlier specs referenced .NET 8/9 (see Documentation Inconsistencies). The platform requires high performance, first-class cloud-native and container support, mature async/messaging libraries, and strong AI integration via Microsoft.Extensions.AI.

Decision

Standardize all backend platforms, microservices, workers, and generated services on .NET 10. Templates, ConnectSoft.Extensions.* libraries, and generation target .NET 10.

Consequences

Positive

• One runtime across factory and generated products; consistent tooling and libraries.
• Latest performance, AOT/trimming options, and native AI integration.
• Long-term support alignment.

Negative / trade-offs

• Residual .NET 8/9 references in legacy spec pages must be normalized over time.

Neutral

• Pins minimum SDK/runtime versions in CI and base images.

Alternatives considered

Alternative	Why not chosen
.NET 8/9	Older; superseded by .NET 10 capabilities and support window.
Mixed runtimes (Node/JVM) per service	Fragments tooling, libraries, and the generation model.

Related

• Technology Stack
• Architecture Principles
• Documentation Inconsistencies