> ## 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.

# Quickstart

> Install ANcpLua.NET.Sdk in your .NET 10 project.

## Prerequisites

<Check>
  [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) installed
</Check>

<Check>[Central Package Management](/index#requirements) enabled</Check>

## Installation

<Steps>
  <Step title="Add SDK reference">
    Add to your `global.json` (create if it doesn't exist):

    ```json title="global.json" theme={null}
    {
        "msbuild-sdks": {
        "ANcpLua.NET.Sdk": "*"
    }
    }
    ```
  </Step>

  <Step title="Update project file">
    Set the `Sdk` attribute to the variant you need:

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

    ```xml title="ASP.NET Core API" theme={null}
    <Project Sdk="ANcpLua.NET.Sdk.Web">
        <PropertyGroup>
            <TargetFramework>net10.0</TargetFramework>
        </PropertyGroup>
    </Project>
    ```

    ```xml title="xUnit v3 Tests" theme={null}
    <Project Sdk="ANcpLua.NET.Sdk.Test">
        <PropertyGroup>
            <TargetFramework>net10.0</TargetFramework>
        </PropertyGroup>
    </Project>
    ```
  </Step>

  <Step title="Build">
    ```bash theme={null}
    dotnet build
    ```
  </Step>
</Steps>

## What's configured

After installation, you automatically get:

* Nullable reference types enabled
* LangVersion `latest`
* Deterministic builds
* Roslyn analyzers
* Banned API enforcement

## Multi-targeting

To support older frameworks alongside .NET 10:

```xml theme={null}
<Project Sdk="ANcpLua.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net10.0;netstandard2.0</TargetFrameworks>
  </PropertyGroup>
</Project>
```

Polyfills are auto-injected for `netstandard2.0` targets. See [Polyfills](/sdk/polyfills).