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=x64

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

Design references

Search documentation

Search the docs

Pages, guides, and reference