microsoft / microsoft/win-dev-skills
winui-packaging: add production signing & distribution guidance (Azure Trusted Signing, .appinstaller, EV/OV certs)
Nobody has claimed this yet.
- Dominant language
- C#
- Stars
- 442
- Forks
- 33
- Avg merge
- 2h 59m
- Merged PRs (30d)
- 11
Description
97: #97
Problem
From Joe's blog post:
It is also worth noting that the WinUI Skill and the WinApp CLI are no help signing the MSIX package for distribution. Luckily I had already worked out signing my artifacts, but that was a serious pain to get repeatable.
Our winui-packaging skill (SKILL.md) covers dev-cert signing thoroughly but production is reduced to a single bullet:
--timestampis critical for production — without it, signatures expire with the cert
That leaves both the agent and the user with no playbook for the actual hard part: how do I get a certificate anyone else's machine will trust? How do I ship updates without re-installing? What does the agent recommend in 2026 — buy an OV cert, an EV cert, or use Azure Trusted Signing?
What's missing
- Azure Trusted Signing — Microsoft's current recommended path; ~$10/mo, no cert lifecycle management, OV trust by default. Today the skill doesn't mention it.
- EV vs OV cert tradeoffs — when each is needed, cost, where to buy, SmartScreen reputation implications.
- Sideload-friendly distribution —
.appinstallerfiles, hosting requirements, MIME types, auto-update channels. - Cert renewal flow — what to do when an existing cert is about to expire; re-sign without breaking existing installs.
- MSIX Hero mention as the de-facto manual diagnostic tool.
- Trusted publisher chain explanation — why
winapp cert installfor a dev cert is not what a customer's machine needs.
Proposed shape
Add plugins/winui/skills/winui-packaging/references/production-signing.md and reference it from SKILL.md under a new "Production distribution" section. Update the skill front-matter description so the agent loads the skill when asked about production signing or distribution channels, not just dev-cert packaging.
Acceptance criteria
- Agent can answer "how do I sign this app for the Microsoft Store / sideload / enterprise install" without hand-waving.
- Azure Trusted Signing is presented as the recommended default with concrete setup steps.
-
.appinstallerflow documented for self-hosted distribution with auto-update. - Cert renewal + countersign-with-timestamp guidance.
- Skill front-matter mentions "production signing" so it loads on intent.
Acknowledgments
Identified by Joe Finney in Building Fluent Icon Finder with the WinUI Copilot skill.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading plugins/winui/skills/winui-packaging/SKILL.md and its current front matter, then use the proposed references/production-signing.md as the documentation entry point. Done means the skill references production guidance covering Azure Trusted Signing, certificate choices and renewal, .appinstaller distribution, trusted publisher chains, and the listed acceptance questions.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure
- Domain
- documentation, release, security
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 72/100