Development Guide
Choose the build instructions for the product you are actually working on.
Important product distinction
guideXOS Server v0.2.1 is the native, multi-architecture-oriented product with a public AMD64 ISO. The older C#/NativeAOT commands on the original guideXOS documentation belong to the separate guideXOS desktop operating system and are not the Server v0.2.1 build process.
Native Server development
Use the actual Server build and testing guide for the bootloader, architecture-selected kernel, ESP staging, hosted runtime, and QEMU/UEFI validation. The public v0.2.1 AMD64 ISO is available for end-user testing; source builds remain the contributor path.
C#/AOT desktop development
The original guideXOS branch has its own C#/AOT, desktop, Legacy BIOS, and UEFI development material. Those instructions belong to guideXOS—not guideXOS Server.
Open guideXOS C# Wiki View guideXOS FeaturesUEFI naming note
guideXOS UEFI is development material within the guideXOS C# branch, not a separately released public guideXOS product. guideXOS Server has its own native UEFI boot path and its own v0.2.1 AMD64 release. Keep those two uses of “UEFI” separate in documentation and issue reports.
Status language for contributors
- Implemented: present in the relevant product's current source and runtime evidence.
- Partial: useful path exists, but parity, integration, or breadth is incomplete.
- Experimental: narrow, constrained, or bring-up-only behavior.
- Planned: design or roadmap material, not a released feature claim.