doc/articles/get-started.md
Install and run <a href="https://aka.platform.uno/uno-check#install-and-run-uno-check" target="_blank">Uno.Check</a> to set up all the required pre-requisites
Download the Uno Platform extension for your IDE:
<!-- markdownlint-disable MD001 MD009 --> <div class="row"> <!-- Visual Studio --> <div class="col-md-4 col-xs-12 "> <a href="https://aka.platform.uno/vs-extension-marketplace" target="_blank"> <div class="alert alert-info alert-hover">Get the VSIX from the marketplace
</div> </a> </div> <!-- Code --> <div class="col-md-4 col-xs-12 "> <a href="https://aka.platform.uno/vscode-extension-marketplace" target="_blank"> <div class="alert alert-info alert-hover">Install the VSIX from the marketplace
</div> </a> </div> <!-- Rider --> <div class="col-md-4 col-xs-12 "> <a href="https://aka.platform.uno/rider-extension-marketplace" target="_blank"> <div class="alert alert-info alert-hover">Get the extension from the marketplace
</div> </a> </div> </div> <!-- row -->Uno Platform allows you to create single-codebase, cross-platform applications that run on iOS, Android, Web, macOS, Linux and Windows. You'll be creating cross-platform .NET applications with XAML and/or C# in no time.
The following sections will guide you through your development environment (including AI agents), a simple Hello World app, and more advanced tutorials.
To set up your development environment, first select the operating system you're developing on.
I am developing on...
Choose the IDE or Agent you want to use:
To help you choose the appropriate IDE or Agent, the following table shows the compatibility of different development environments with various target platforms:
| Visual Studio | VS Code | Codespaces | Rider | Claude Code | Codex | GitHub Copilot CLI | Cursor | Google Antigravity | |
|---|---|---|---|---|---|---|---|---|---|
| Desktop (Skia)¹ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Android | ✔️ | ✔️⁴ | ❌ | ✔️ | ⏳⁴ | ⏳⁴ | ⏳⁴ | ⏳⁴ | ⏳⁴ |
| iOS | ✔️² | ✔️² | ❌ | ✔️² | ❌ | ❌ | ❌ | ❌ | ❌ |
| Web (WebAssembly) | ✔️ | ✔️ | ✔️ | ✔️³ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| WinAppSDK | ✔️ | ⏳⁴ | ❌ | ✔️ | ⏳⁴ | ⏳⁴ | ⏳⁴ | ⏳⁴ | ⏳⁴ |
Notes:
You can use Visual Studio Code or JetBrains Rider, to build Uno Platform applications on macOS. See the support matrix below for supported target platforms.
Choose the IDE or Agent you want to use:
To help you choose the appropriate IDE or Agent, the following table shows the compatibility of different development environments with various target platforms:
| VS Code | Codespaces | Rider | Claude Code | Codex | GitHub Copilot CLI | Cursor | Google Antigravity | |
|---|---|---|---|---|---|---|---|---|
| Desktop (Skia)¹ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Android | ✔️² | ❌ | ✔️ | ⏳² | ⏳² | ⏳² | ⏳² | ⏳² |
| iOS | ✔️ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Web (WebAssembly) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| WinAppSDK | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Notes:
The latest macOS release and Xcode version are required to develop with Uno Platform for iOS targets. If you have older Mac hardware that does not support the latest release of macOS, see the section for Developing on older Mac hardware.
You can use either JetBrains Rider or Visual Studio Code to build Uno Platform applications on Linux. See the support matrix below for supported target platforms.
Choose the IDE or Agent you want to use:
To help you choose the appropriate IDE or Agent, the following table shows the compatibility of different development environments with various target platforms:
| VS Code | Codespaces | Rider | Claude Code | Codex | GitHub Copilot CLI | Cursor | Google Antigravity | |
|---|---|---|---|---|---|---|---|---|
| Desktop (Skia)¹ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Web (WebAssembly) | ✔️ | ✔️ | ✔️² | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Android | ✔️³ | ❌ | ✔️ | ⏳³ | ⏳³ | ⏳³ | ⏳³ | ⏳³ |
| iOS | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| WinAppSDK | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Notes:
Choosing the right agent for your development depends on your needs and environments. The following table summarizes the features supported by various agents for Uno Platform development:
| Agent | Version | Tools | Prompts | Hot Reload | mcp.json | Platforms | Comments |
|---|---|---|---|---|---|---|---|
| VS 2022 Copilot | 17.14.16 | ✅ | ❌ | ⏳¹ | ✅ | iOS, Android, Desktop, Web | |
| VS 2026 Copilot | 18.0.0 Pre 1 | ✅ | ❌ | ⏳¹ | ✅ | iOS, Android, Desktop, Web | |
| VS Code Copilot | 1.105.1 | ✅ | ✅ | ✅ | ✅ | iOS, Android, Desktop, Web | |
| GitHub Copilot CLI | 0.0.349 | ✅ | ❌ | ✅ | ❌ | Desktop, Web | |
| Cursor | 2.0.34 | ✅ | ✅ | ✅ | ✅ | Desktop, Web | |
| Google Antigravity | Preview | ✅ | ❌ | ✅ | ❌ | Desktop, Web | Roots fallback auto-detected |
| Rider | 2025.2 | ✅² | ❌ | ❌ | ✅² | Desktop, Web | Uno App MCP (stdio) only — Uno Docs (HTTP) tracked in JUNIE-461 |
| Codex CLI | 0.50.0 | ✅ | ❌ | ✅ | ❌ | Desktop, Web | mcp.json |
| Claude Code | 2.0.25 | ✅ | ✅ | ✅ | ✅ | Desktop, Web |
Notes:
For registration, inspection, and diagnostics of Uno MCPs across these agents, see The Uno Platform MCPs and the Dev Server reference.
For questions about Uno Platform, refer to the general FAQ or see the troubleshooting section for common issues and their solutions.
Choose the IDE or Agent to Learn more about: