Add Node.js sample using a native WinUI 3 Application and Window

[lei9444]

Description

Usage Example

Related Issue

Type of Change

• 🐛 Bug fix
• ✨ New feature
• 💥 Breaking change
• 📝 Documentation
• 🔧 Config/build
• ♻️ Refactoring
• 🧪 Test update

Checklist

• New tests added for new functionality (if applicable)
• Tested locally on Windows
• Main README.md updated (if applicable)
• docs/usage.md updated (if CLI commands changed)
• Language-specific guides updated (if applicable)
• Sample projects updated to reflect changes (if applicable)
• Agent skill templates updated in docs/fragments/skills/ (if CLI commands/workflows changed)

Screenshots / Demo

Additional Notes

AI Description

This pull request introduces a new sample demonstrating how to create a WinUI 3 application and window directly from Node.js, using the Microsoft.UI.Xaml controls projected into JavaScript. It includes necessary files like main.js, package.json, and a README for usage instructions. To run the sample, use the following commands:

npm install
npm run restore
npm start

[github-actions]

Build Metrics Report

Binary Sizes

Artifact	Baseline	Current	Delta
CLI (ARM64)	36.77 MB	36.77 MB	✅ 0.0 KB (0.00%)
CLI (x64)	36.95 MB	36.95 MB	✅ 0.0 KB (0.00%)
MSIX (ARM64)	15.36 MB	15.36 MB	📈 +0.1 KB (+0.00%)
MSIX (x64)	16.30 MB	16.30 MB	📉 -0.0 KB (-0.00%)
NPM Package	32.06 MB	32.06 MB	📈 +0.3 KB (+0.00%)
NuGet Package	32.09 MB	32.09 MB	📈 +0.0 KB (+0.00%)

Test Results

✅ 3338 passed, 4 skipped out of 3342 tests in 872.9s (+135.3s vs. baseline)

Test Coverage

✅ 86.3% line coverage, 80% branch coverage · ✅ no change vs. baseline

CLI Startup Time

52ms median (x64, winapp --version) · ✅ no change vs. baseline

---

Updated 2026-07-16 13:46:21 UTC · commit 35c3701 · workflow run

[Copilot]

Pull request overview

Adds a new Node.js sample that demonstrates creating a native WinUI 3 Application + Window directly from JavaScript using dynwinrt, along with CI coverage to keep the sample working over time.

Changes:

• Adds the samples/node-winui sample project (restore/generate scripts, WinUI worker implementation, and documentation).
• Adds a Pester test for the new sample and wires it into the test-samples.yml matrix.
• Updates the repo root README.md to include the new sample in the Samples table.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
samples/node-winui/winui-worker.js	Worker-thread WinUI Application.start() sample UI composition + event wiring.
samples/node-winui/main.js	Bootstraps Windows App SDK and starts the WinUI worker.
samples/node-winui/package.json	Declares sample scripts, #winapp/bindings imports, dynwinrt deps, and winapp.jsBindings config.
samples/node-winui/README.md	Sample usage + architecture explanation + binding regeneration guidance.
samples/node-winui/winapp.yaml	WinApp restore package set for generating WinUI bindings.
samples/node-winui/test.Tests.ps1	Pester validation for restore + generated bindings + basic JS syntax checks.
samples/node-winui/.gitignore	Ignores .winapp/ output and node_modules/.
samples/node-winui/.npmrc	Sets npm registry (see review comment).
README.md	Fixes formatting in install section and adds the new sample to the Samples table.
.github/workflows/test-samples.yml	Adds node-winui to workflow_dispatch options, matrix, and Node setup gating.

---

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