feat: add Native AOT documentation by jonpryor · Pull Request #22935 · unoplatform/uno

jonpryor · 2026-03-31T19:32:33Z

Context: https://github.com/unoplatform/uno-private/issues/1440

PR Type:

What is the current behavior? 🤔

What is the new behavior? 🚀

PR Checklist ✅

Please check if your PR fulfills the following requirements:

📝 Commits must be following the Conventional Commits specification.
🧪 Added Runtime tests, UI tests, or a manual test sample for the changes have been added (for bug fixes / features) (if applicable)
📚 Docs have been added/updated which fit documentation template (for bug fixes / features)
🖼️ Validated PR Screenshots Compare Test Run results.
❗ Contains NO breaking changes

Other information ℹ️

Copilot

Pull request overview

Adds a new documentation page describing Uno Platform Native AOT support and links it into the docs table of contents so it’s discoverable alongside other performance/publishing topics.

Changes:

Add a new Native AOT Support documentation page under doc/articles/features/.
Add a TOC entry pointing to the new page.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
doc/articles/toc.yml	Adds a navigation entry for the new Native AOT documentation page.
doc/articles/features/native-aot.md	Introduces a new Native AOT guidance page (overview, CLI publish guidance, limitations, and mitigation tips).

Comments suppressed due to low confidence (1)

doc/articles/features/native-aot.md:300

The content after the horizontal rule reads like a draft/summary block and is not formatted as structured documentation (lists are plain lines, no headings, and it duplicates earlier points). Please either remove it or convert it into proper sections with markdown lists/headings so it renders correctly and stays maintainable.

[uno-chefs]: https://github.com/unoplatform/uno.chefs/commit/06f4f804
[uno-gallery]: https://github.com/unoplatform/Uno.Gallery/commit/b8544a43da13b59ab4355af6dfcb27c9047fffbb

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

unodevops · 2026-03-31T19:50:35Z

⚠️⚠️ The build 204852 has failed on Uno.UI - docs.

agneszitte · 2026-03-31T19:55:34Z

+| **Sample**                                            | **Environment**   | **Runtime** |          **Publish Size** |     **Startup Times (s)** |
+| ----------------------------------------------------- | ----------------- | ----------- | ------------------------: | ------------------------: |
+| [Uno.Gallery][uno-gallery] with Uno.Sdk 6.6.0-dev.127 | iOS, .NET 10      | MonoVM      |  84M                      | 2.241s |
+| [Uno.Gallery][uno-gallery] with Uno.Sdk 6.6.0-dev.127 | iOS, .NET 10      | NativeAOT   |  65M <BR> (77% MonoVM)    | 0.978s <BR> (44% MonoVM)  |
+| [Uno.Chefs][uno-chefs] with Uno.Sdk 6.6.0-dev.127     | Linux, .NET 10    | CoreCLR     |  450M                     | 2.58s |
+| [Uno.Chefs][uno-chefs] with Uno.Sdk 6.6.0-dev.127     | Linux, .NET 10    | NativeAOT   |  533M <BR> (118% CoreCLR) | 1.06s <BR> (41% CoreCLR)  |
+| [Uno.Chefs][uno-chefs] with Uno.Sdk 6.6.0-dev.127     | macOS, .NET 10    | CoreCLR     |  457M                     | 3.805s |
+| [Uno.Chefs][uno-chefs] with Uno.Sdk 6.6.0-dev.127     | macOS, .NET 10    | NativeAOT   |  645M <BR> (140% CoreCLR) | 1.162s <BR> (31% CoreCLR) |
+| [Uno.Chefs][uno-chefs] with Uno.Sdk 6.6.0-dev.127     | Windows, .NET 10  | CoreCLR     |  457M                     | 2.408s |
+| [Uno.Chefs][uno-chefs] with Uno.Sdk 6.6.0-dev.127     | Windows, .NET 10  | NativeAOT   |  624M <BR> (137% CoreCLR) | 0.737s <BR> (31% CoreCLR) |


Do we want those dev versions for public docs ? or just a placeholder for now until we have results with stable next version released ?

@agneszitte: Mostly a placeholder. There's a bit of a "circular dependency" here, as a stable 6.6.x doesn't exist yet -- nor do I know when it will exist -- but we want something meaningful.

Assuming that this table is the "something meaningful" we want to present. Maybe we want something different?

@jonpryor Let's keep it for now until we have the rest of the documentation done, and then we can review with the Team

unodevops · 2026-04-01T21:19:36Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22935/docs/index.html

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

unodevops · 2026-04-02T20:44:38Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22935/docs/index.html

Context: unoplatform/uno-private#1440

unodevops · 2026-04-03T12:35:01Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22935/docs/index.html

- Add missing `---` terminator after Prerequisites tab group (line 39) - Add missing `---` terminator after Log Everything tab group (line 203) - Fix [!NOTE] admonitions to use blockquote syntax (`> [!NOTE]`)

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

unodevops · 2026-04-03T14:00:18Z

⚠️⚠️ The build 205462 has failed on Uno.UI - docs.

I wonder if two `[!NOTE]` blocks in a row is valid…

unodevops · 2026-04-03T15:40:51Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22935/docs/index.html

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

unodevops · 2026-04-03T16:26:26Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22935/docs/index.html

unodevops · 2026-04-03T19:15:01Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22935/docs/index.html

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

unodevops · 2026-04-06T19:49:21Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22935/docs/index.html

Copilot AI review requested due to automatic review settings March 31, 2026 19:32

github-actions Bot added area/build Categorizes an issue or PR as relevant to build infrastructure kind/documentation labels Mar 31, 2026

github-actions Bot assigned jonpryor Mar 31, 2026

Copilot started reviewing on behalf of jonpryor March 31, 2026 19:33 View session

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from 6f76bb7 to 79b8559 Compare March 31, 2026 19:34

Copilot AI reviewed Mar 31, 2026

View reviewed changes

Comment thread doc/articles/features/native-aot.md Outdated

Comment thread doc/articles/features/native-aot.md Outdated

Comment thread doc/articles/features/native-aot.md Outdated

Comment thread doc/articles/features/native-aot.md Outdated

agneszitte reviewed Mar 31, 2026

View reviewed changes

jonpryor marked this pull request as draft April 1, 2026 20:00

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from 79b8559 to 6e6eefc Compare April 1, 2026 20:52

Copilot AI review requested due to automatic review settings April 2, 2026 20:07

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from 6e6eefc to b3fd173 Compare April 2, 2026 20:07

Copilot started reviewing on behalf of jonpryor April 2, 2026 20:08 View session

Copilot AI reviewed Apr 2, 2026

View reviewed changes

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from b3fd173 to 1767348 Compare April 2, 2026 20:11

Copilot AI review requested due to automatic review settings April 2, 2026 20:19

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from 1767348 to 19e502f Compare April 2, 2026 20:19

Copilot started reviewing on behalf of jonpryor April 2, 2026 20:20 View session

Copilot AI reviewed Apr 2, 2026

View reviewed changes

Comment thread doc/articles/features/native-aot.md Outdated

Comment thread doc/articles/features/native-aot.md

Comment thread doc/articles/features/native-aot.md

Comment thread doc/articles/features/native-aot.md

feat: add Native AOT documentation

7a5a96d

Context: unoplatform/uno-private#1440

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from 19e502f to 7a5a96d Compare April 3, 2026 12:13

fix(docs): close tab groups and fix admonition syntax in native-aot.md

bb25089

- Add missing `---` terminator after Prerequisites tab group (line 39) - Add missing `---` terminator after Log Everything tab group (line 203) - Fix [!NOTE] admonitions to use blockquote syntax (`> [!NOTE]`)

Copilot AI review requested due to automatic review settings April 3, 2026 13:47

Copilot started reviewing on behalf of agneszitte April 3, 2026 13:47 View session

Copilot AI reviewed Apr 3, 2026

View reviewed changes

Comment thread doc/articles/features/native-aot.md

Comment thread doc/articles/features/native-aot.md

Comment thread doc/articles/features/native-aot.md Outdated

Comment thread doc/articles/features/native-aot.md Outdated

agneszitte reviewed Apr 3, 2026

View reviewed changes

Comment thread doc/articles/features/native-aot.md Outdated

fix(docs): close tab groups and fix admonition syntax in native-aot.md

8062d39

I wonder if two `[!NOTE]` blocks in a row is valid…

Copilot AI review requested due to automatic review settings April 3, 2026 16:03

Copilot started reviewing on behalf of jonpryor April 3, 2026 16:04 View session

Copilot AI reviewed Apr 3, 2026

View reviewed changes

Comment thread doc/articles/features/native-aot.md

Comment thread doc/articles/features/native-aot.md Outdated

Comment thread doc/articles/features/native-aot.md Outdated

Comment thread doc/articles/features/native-aot.md Outdated

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from 57bd4c7 to efb23cd Compare April 3, 2026 18:46

feat: update Native AOT documentation

f58e03a

Copilot AI review requested due to automatic review settings April 6, 2026 19:22

jonpryor force-pushed the dev/jonpryor/jonp-nativeaot-docs branch from efb23cd to f58e03a Compare April 6, 2026 19:22

Copilot started reviewing on behalf of jonpryor April 6, 2026 19:22 View session

Copilot AI reviewed Apr 6, 2026

View reviewed changes

Conversation

jonpryor commented Mar 31, 2026

PR Type:

What is the current behavior? 🤔

What is the new behavior? 🚀

PR Checklist ✅

Other information ℹ️

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

unodevops commented Mar 31, 2026

Uh oh!

agneszitte Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

jonpryor Apr 1, 2026

Choose a reason for hiding this comment

Uh oh!

agneszitte Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

unodevops commented Apr 1, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

unodevops commented Apr 2, 2026

Uh oh!

unodevops commented Apr 3, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

unodevops commented Apr 3, 2026

Uh oh!

Uh oh!

unodevops commented Apr 3, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

unodevops commented Apr 3, 2026

Uh oh!

unodevops commented Apr 3, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview