> ## Documentation Index
> Fetch the complete documentation index at: https://ancplua.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ANcpLua.NET.Sdk

> MSBuild SDK with Roslyn analyzers, polyfills, and sensible defaults for .NET 10.

## Install

```json title="global.json" theme={null}
{
  "msbuild-sdks": {
    "ANcpLua.NET.Sdk": "1.6.7"
  }
}
```

```xml title="YourProject.csproj" theme={null}
<Project Sdk="ANcpLua.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
  </PropertyGroup>
</Project>
```

## SDK Variants

| SDK                    | Use Case                                                                                                                              | Docs                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| `ANcpLua.NET.Sdk`      | Libraries, Console, Workers                                                                                                           | [Overview](/sdk/overview)          |
| `ANcpLua.NET.Sdk.Web`  | ASP.NET Core APIs                                                                                                                     | [Web variant](/sdk/variants#web)   |
| `ANcpLua.NET.Sdk.Test` | xUnit v3 with [Microsoft Testing Platform](https://learn.microsoft.com/en-us/dotnet/core/testing/microsoft-testing-platform-overview) | [Test variant](/sdk/variants#test) |

## Included

**All variants:**

* [Roslyn analyzers](/analyzers/overview) for code quality
* [Banned APIs](/sdk/banned-apis) enforcement (legacy → modern)
* `Throw.IfNull()` guard clauses
* LangVersion `latest`, nullable enabled
* [Polyfills](/sdk/polyfills) for netstandard2.0 targets

**Web variant adds:**

* OpenTelemetry integration (logging, metrics, tracing)
* Health endpoints (`/health`, `/alive`)
* HTTP resilience via Polly

**Test variant adds:**

* xUnit v3 with Microsoft Testing Platform
* Code coverage collection

## Requirements

<Warning>
  **Central Package Management required.** Create this file if you don't have
  it:
</Warning>

```xml title="Directory.Packages.props" theme={null}
<Project>
  <PropertyGroup>
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>
</Project>
```

<Card title="Get started" icon="rocket" href="/quickstart">
  Step-by-step installation guide
</Card>