Merge branch 'main' into copilot/add-custom-location-winapp

Author: nmetulev

.github/workflows/build-package.yml

@@ -22,7 +22,7 @@ jobs:
     - name: Install .NET Core
       uses: actions/setup-dotnet@v5
       with:
-        dotnet-version: 9.0.x
+        dotnet-version: 10.0.x
 
     - name: Setup Node.js
       uses: actions/setup-node@v5
@@ -53,21 +53,28 @@ jobs:
       with:
         name: test-results
         path: artifacts/TestResults/*.trx
+        if-no-files-found: error
 
     - name: Upload CLI binaries
+      if: ${{ !cancelled() }}
       uses: actions/upload-artifact@v4
       with:
         name: cli-binaries
         path: artifacts/cli/
+        if-no-files-found: error
 
     - name: Upload npm package
+      if: ${{ !cancelled() }}
       uses: actions/upload-artifact@v4
       with:
         name: npm-package
         path: artifacts/*.tgz
-    
+        if-no-files-found: error
+
     - name: Upload MSIX packages
+      if: ${{ !cancelled() }}
       uses: actions/upload-artifact@v4
       with:
         name: msix-packages
-        path: artifacts/msix-packages/*.msix
+        path: artifacts/msix-packages/*.msix
+        if-no-files-found: error

.pipelines/ci.yml

@@ -32,9 +32,9 @@ extends:
         steps:
           - checkout: self
           - task: UseDotNet@2
-            displayName: Setup .NET 9
+            displayName: Setup .NET 10
             inputs:
-              version: 9.0.x
+              version: 10.0.x
           - task: UseNode@1
             displayName: Setup Node.js 24
             inputs:

.pipelines/release.yml

@@ -46,9 +46,9 @@ extends:
         steps:
           - checkout: self
           - task: UseDotNet@2
-            displayName: Setup .NET 9
+            displayName: Setup .NET 10
             inputs:
-              version: 9.0.x
+              version: 10.0.x
           - ${{ if eq(parameters.DoEsrp, 'true') }}:
             - task: UseDotNet@2
               displayName: Setup .NET 6.0 (For ESRP Task)
@@ -208,8 +208,8 @@ extends:
     #             contentsource: 'Folder'
     #             folderlocation: $(Pipeline.Workspace)/npm-package/
     #             waitforreleasecompletion: true
-    #             owners: '[email protected]'
-    #             approvers: '[email protected]'
+    #             owners: '$(EsrpOwnersEmail)'
+    #             approvers: '$(EsrpApproversEmail)'
     #             serviceendpointurl: 'https://api.esrp.microsoft.com'
     #             mainpublisher: 'winappcli'
     #             domaintenantid: ${{ parameters.signingIdentity.tenantId }}
@@ -261,8 +261,7 @@ extends:
                 Write-Host "ARM64 MSIX: $arm64MsixUrl"
                 
                 # Submit to WinGet repository
-                # Commented out for now to prevent accidental submissions
-                # wingetcreate update Microsoft.WinAppCli `
-                #   --version $(version) `
-                #   --urls $x64MsixUrl $arm64MsixUrl `
-                #   --submit
+                wingetcreate update Microsoft.WinAppCli `
+                 --version $(version) `
+                  --urls $x64MsixUrl $arm64MsixUrl `
+                  --submit

README.md

@@ -1,3 +1,8 @@
+# Windows App Development CLI
+
+> [!IMPORTANT]
+> :warning: **Status: Public Preview** - The Windows App Development CLI is experimental and in active development. We'd love your feedback! Share your thoughts by creating an [issue](https://github.com/microsoft/WinAppCli/issues).
+
 <p align="center">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="./docs/images/hero-dark.png">
@@ -8,25 +13,22 @@
 
 <h3 align="center">
   <a href="#-installation">Installation</a>
-  <span> . </span>
+  <span> • </span>
   <a href="#-usage">Usage</a>
-  <span> . </span>
+  <span> • </span>
   <a href="./docs/usage.md">Documentation</a>
-  <span> . </span>
+  <span> • </span>
   <a href="#-try-the-windows-identity-app">GUI</a>
-  <span> . </span>
+  <span> • </span>
   <a href="#-feedback">Feedback</a>
 </h3>
-<br/><br/>
-
-> [!IMPORTANT]  
-> The Windows App Development CLI is in preview and in active development, and we'd love your feedback! Share your thoughts by creating an [issue](https://github.com/microsoft/WinAppCli/issues).
+<br/>
 
 The Windows App Development CLI is a single command-line interface for managing Windows SDKs, packaging, generating app identity, manifests, certificates, and using build tools with any app framework. This tool bridges the gap between cross-platform development and Windows-native capabilities.
 <br/><br/>
 Whether you're building with Electron, .NET/Win32, CMake, or Python, this CLI gives you access to:
 
-- **Modern Windows APIs** - Windows App SDK and Windows SDK with automatic setup and code generation
+- **Modern Windows APIs** - [Windows App SDK](https://learn.microsoft.com/windows/apps/windows-app-sdk/) and Windows SDK with automatic setup and code generation
 - **App Identity** - Debug and test by adding app identity without full packaging in a snap
 - **MSIX Packaging** - App packaging with signing and Store readiness
 - **Developer Tools** - Manifests, certificates, assets, and build integration
@@ -53,7 +55,9 @@ The easiest way to use the CLI is to download the latest build from GitHub Relea
 
 ### Adding to Path
 
-The easiest way to use the CLI globally is to install it via the MSIX installer
+The easiest way to use the CLI globally is to install it via the [MSIX installer](https://github.com/microsoft/WinAppCli/releases/latest).
+
+You can also add it manually: Windows Search → Edit the system environment variables → Environment Variables → Path → Edit → New → Add the location (folder) of winapp CLI.
 
 ## 📋 Usage
 
@@ -105,25 +109,30 @@ The full CLI usage can be found here: [Documentation](/docs/usage.md)
 - [File an issue, feature request or bug](https://github.com/microsoft/WinAppCli/issues): please ensure that you are not filing a duplicate issue
 - Send feedback to <[email protected]>: Do you love this tool? Are there features or fixes you want to see? Let us know!
 
-We are actively working on improving Node and Python support. These features are currently experimental and we are aware of several issues with these app types.
+We are actively working on improving Node and Python support. These features are experimental and we are aware of several issues with these app types.
 
 ## 🧪 Try the Windows Identity App
 
-This repository also contains an **experimental** app (GUI) that wraps the CLI and provides an intuitive, drag-and-drop experience. [See the docs](/docs/gui-usage.md) for more details.
+This repository also contains an **experimental** app (GUI) that wraps the CLI and provides an intuitive, drag-and-drop experience. [See the docs](/docs/gui-usage.md) for more details. [Download the app here](https://github.com/microsoft/WinAppCli/releases/tag/v0.1.1-gui).
+
+## 🧾 Samples
+
+This repository will continue to be added with samples. Currently the following samples exist:
+
+- [Electron sample](/samples/electron/README.md): a default Electron Forge generated application + initialized a winapp project with appxmanifest, assets + native addon + C# addon + generates cert
+
+## Support
+
+Need help or have questions about the Windows App Development CLI? Visit our **[Support Guide](./SUPPORT.md)** for information about our issue templates and triage process.
 
 ## Contributing
 
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
-Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit [Contributor License Agreements](https://cla.opensource.microsoft.com).
+This project welcomes contributions and suggestions.  Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit [Contributor License Agreements](https://cla.opensource.microsoft.com).
 
-When you submit a pull request, a CLA bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repos using our CLA.
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
 
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
-contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
 
 To build the CLI:
 ```

SUPPORT.md

@@ -1,25 +1,58 @@
-# TODO: The maintainer of this repo has not yet edited this file
+# Support
 
-**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
+## How to file issues and get help
 
-- **No CSS support:** Fill out this template with information about how to file issues and get help.
-- **Yes CSS support:** Fill out an intake form at [aka.ms/onboardsupport](https://aka.ms/onboardsupport). CSS will work with/help you to determine next steps.
-- **Not sure?** Fill out an intake as though the answer were "Yes". CSS will help you decide.
+This project uses GitHub Issues to track bugs and feature requests. Please search the existing issues before filing new issues to avoid duplicates.
 
-*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
+### Filing Issues
 
-# Support
+We have specific issue templates to help you provide the right information:
+
+- **[Bug Report](https://github.com/microsoft/WinAppCli/issues/new?template=bug-report.md)** - Report something that isn't working correctly
+- **[Feature Request](https://github.com/microsoft/WinAppCli/issues/new?template=feature_request.md)** - Suggest a new feature or enhancement
+- **[General Issues](https://github.com/microsoft/WinAppCli/issues)** - File any other type of issue or browse existing issues
+
+Please ensure that you are not filing a duplicate issue by searching existing issues first.
+
+### Getting Help
+
+For help and questions about using this project:
+
+1. Check our [documentation](./docs/usage.md) for detailed usage instructions
+2. Browse existing [GitHub Issues](https://github.com/microsoft/WinAppCli/issues) for similar questions
+3. File a new issue with the `question` label if you need additional help
+
+## Issue Triage
+
+Our team actively monitors and manages  issues in this repository.
+
+- **Bug Reports and questions**: Critical bugs are prioritized and addressed as quickly as possible. Questions will be monitored.
+- **Feature Requests**: Evaluated during regular planning cycles
+
+### When a New Issue is Created
+
+All new issues are automatically reviewed and tagged with appropriate labels:
+
+- **Type**: `bug`, `enhancement`, `question`, `documentation`
+- **Framework/language**: `dotnet`, `electron`, `javascript`, `python`, `gui` (based on the affected area)
+- **Priority**: `good first issue`, `help wanted` (for community contribution opportunities)
+
+### Investigation
+
+As we investigate and work on issues, additional labels are applied:
+
+- **`known-issue`** - Applied to issues the team has identified and is tracking
+- **`needs:docs`** - Issues that require documentation updates or clarification
+- **`dependencies`** - Issues related to external dependency updates
 
-## How to file issues and get help  
+### Closing Issues
 
-This project uses GitHub Issues to track bugs and feature requests. Please search the existing 
-issues before filing new issues to avoid duplicates.  For new issues, file your bug or 
-feature request as a new Issue.
+When closing issues, we apply final classification labels:
 
-For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
-FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
-CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
+- **`duplicate`** - Issue already reported elsewhere (includes link to original)
+- **`invalid`** - Issue doesn't seem right or cannot be reproduced
+- **`wontfix`** - Issue will not be addressed (with explanation in comments)
 
-## Microsoft Support Policy  
+## Microsoft Support Policy
 
-Support for this **PROJECT or PRODUCT** is limited to the resources listed above.
+Support for the Windows App Development CLI is limited to the resources listed above. This is an open-source project maintained by Microsoft, and community contributions are welcome.

docs/gui-usage.md

@@ -33,7 +33,7 @@ Clone and build this repository. Run winapp.cli in Visual Studio to build and ru
 
 ### Download the MSIX (build pipeline in progress)
 
-1. **[👉 Download Latest Experimental Build (unsigned .msix)](https://github.com/microsoft/WinAppCli/releases/latest)**
+1. **[👉 Download Latest Experimental Build (unsigned .msix)](https://github.com/microsoft/WinAppCli/releases/tag/v0.1.1-gui)**
 2. Run Powershell as **Administrator** and `Add-AppPackage -Path <msix> -AllowUnsigned`
 
 `<msix>` should be replaced with the full path of the downloaded build (msix file).