Runic.Translations
0.3.0-preview.1
dotnet add package Runic.Translations --version 0.3.0-preview.1
NuGet\Install-Package Runic.Translations -Version 0.3.0-preview.1
<PackageReference Include="Runic.Translations" Version="0.3.0-preview.1" />
<PackageVersion Include="Runic.Translations" Version="0.3.0-preview.1" />
<PackageReference Include="Runic.Translations" />
paket add Runic.Translations --version 0.3.0-preview.1
#r "nuget: Runic.Translations, 0.3.0-preview.1"
#:package Runic.Translations@0.3.0-preview.1
#addin nuget:?package=Runic.Translations&version=0.3.0-preview.1&prerelease
#tool nuget:?package=Runic.Translations&version=0.3.0-preview.1&prerelease
Runic.Translations
Run compiled translations in .NET applications with immutable locale snapshots, typed formatting, fallback, and atomic locale switching. The runtime is UI-framework independent, reflection-free, and compatible with NativeAOT.
Install
dotnet add package Runic.Translations --version <VERSION>
Replace <VERSION> with the current preview shown on NuGet. The package targets .NET 10. For generated catalogs, install Runic.Translations.Build at the same exact version; it owns the generator, catalog item mapping, and optional non-C# artifacts.
Use a generated catalog
Given the project template's starter catalog with code.className set to AppText, the generator creates registration and typed accessors:
using Example.Translations;
using Runic.Translations;
ITranslationManager manager = await AppTextCatalog.CreateManagerAsync(
initialLocale: "en");
var text = new AppText(manager);
Console.WriteLine(text.Application.Name);
await manager.SetLocaleAsync("de");
Console.WriteLine(text.Application.Name);
Each successful locale change replaces the complete immutable snapshot. Reads through manager.Current do not observe a partially updated catalog.
When to choose this package
Choose Runic.Translations for application runtime behavior: generated catalog data, locale resolution, formatting, structured content, translation references, and optional verified external packs. Choose Runic.Translations.Tooling when building an editor, compiler host, or workspace tool.
External packs are untrusted until their artifact version, catalog, locale, contract fingerprint, keys, argument contracts, and limits have been verified. Applications that require authenticity must also supply an integrity verifier; schema validation alone does not establish provenance.
Compatibility and status
This package is a public preview for .NET 10. Preview releases may contain documented breaking API changes. Keep the runtime and generated source on the same Runic Translations release; runtime ABI mismatches fail explicitly.
- Runtime and generated C# example
- NativeAOT example
- Compatibility policy
- External translation pack contract
- Issues and support
Licensed under the MIT License. See Third-Party Notices for bundled data attribution.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Runic.Translations:
| Package | Downloads |
|---|---|
|
Runic.Application.Hosting
Generic Host and ASP.NET Core integration for Runic.Application. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.3.0-preview.1 | 56 | 9/11/2026 |
| 0.2.0-preview.1 | 69 | 9/9/2026 |