Contributing to the Atlas Toolbox
On this page
This guide is for contributors who want to change, build or test Atlas Toolbox. Read the contribution guide first.
Clone the Atlas Toolbox repository before you continue. Its README is the source of truth for build requirements and release rules.
What Atlas Toolbox is built with
Atlas Toolbox is a C# app built with WinUI 3 and the Windows App SDK, on .NET.
Development tools:
- Visual Studio with the WinUI application development workload. The repository restores the NuGet packages it needs.
- Or the .NET SDK on its own, which can build the app from the command line.
Build from the command line:
dotnet build AtlasToolbox\AtlasToolbox.csproj -p:Platform=x64Test your changes
The Toolbox reads the toggles that Atlas installs and applies them the way the Atlas folder’s launchers do. It needs a PC with Atlas installed, so run it in a virtual machine. The README explains which Atlas files it reads and where it keeps its own settings and logs.
Translations
Translate the Toolbox through its Crowdin project, not through pull requests to the language files.