GeezerVison is showing github.com — docs: Windows platform by triniwiz · Pull Request #201 · NativeScript/docs
Conversation
Adds documentation for the experimental Windows platform (WinUI 3 / Windows App SDK). The Windows content goes next to the existing Android and iOS content, and every Windows page and section is marked experimental.
New pages
- Developing for Windows (
guide/windows/): requirements, adding the platform, running, platform-specific code (.windows.ts, __WINDOWS__, <windows>, .ns-windows), native API access, plugins and known limitations.
- Windows Marshalling: WinRT ↔ JS type mapping, structs, date/time, collections, out parameters, events with
NSWinRT.asDelegate, async with NSWinRT.toPromise, .NET and Win32.
- Adding Windows native code:
App_Resources/Windows/app.csproj, NuGet packages, your own C#, C++/WinRT components, Win32 DLLs, plugin native folders.
- Extending WinRT classes and implementing interfaces
- Publishing to the Microsoft Store: signed MSIX for sideloading, and
.msixupload for Partner Center.
Updated pages
- Setup: a Windows column in the setup matrix and a "Windows desktop" setup guide (.NET 10 SDK, Developer Mode,
ns doctor windows).
- Workflow: running, CLI basics and debugging (
ns debug windows, inspector port 43000, --debug-brk/--start, console and crash logs, Visual Studio).
- Configuration: the
windows.* section of the config reference, App_Resources/Windows (manifest, logos, display name and splash properties, DPI awareness), and __WINDOWS__ / --env.windows in the Vite and webpack references.
- Concepts: metadata, multithreading, typings (
ns typings windows), styling, platform-file splitting and troubleshooting.
- UI: the WinUI 3 native component on every UI component page.
- Navigation: the sidebar.
Depends on
- NativeScript/nativescript-cli
feat/windows: the debug URL on port 43000, the doctor checks, and the --no-auto-guid fix.
- feat: start the inspector for ns debug windows on port 43000 windows#19: inspector start and
--debug-brk.
- The App_Resources page links to
shared-mobile/App_Resources/Windows in nativescript-app-templates main. That folder is still on the templates repo's feat/windows branch.
Checked with prettier and textlint; every internal link and anchor these pages add resolves.
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
Covers setup, running, debugging, publishing to the Microsoft Store, App_Resources/Windows, the windows config block, marshalling, native code, subclassing and the WinUI 3 native component of each UI element.
coderabbitai
Bot
commented
Sep 30, 2026
•
edited
Loading
Uh oh!
There was an error while loading. Please reload this page.
Important
Review skipped
Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
- Configuration used: Organization UI
- Review profile: CHILL
- Plan: Advanced
- Run ID:
0454a7b0-5836-45e2-8e6f-ea950f7dd1c8
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
- Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
|
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
Deploying nativescript-docs-latest with Cloudflare Pages
View logs
|
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
- Extending WinRT and .NET classes: class syntax, extend(), super, constructor
arguments, interfaces, @NativeClass/ES5 output, lifetime; no build step.
- C# sources in App_Resources/Windows and plugin platforms/windows are compiled
into the app and reachable by namespace; NuGet namespaces need no
registration; Tasks are awaitable; JS functions and plain objects for
delegates and structs.
- Background-thread callbacks run on the UI thread; the layout-mutation crash
warning is gone; static events on class constructors.
Uh oh!
There was an error while loading. Please reload this page.
Assignees
No one assigned
Milestone
No milestone
Development
Successfully merging this pull request may close these issues.
Uh oh!
There was an error while loading. Please reload this page.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
|