Skip to content

build: apply to SignPath Foundation for free Windows code signing #152

@smith-and-web

Description

@smith-and-web

Problem

Windows SmartScreen warnings create friction for non-technical users. The warning "Windows protected your PC" with "Microsoft Defender SmartScreen prevented an unrecognized app from starting" causes users to abandon installation.

Unlike macOS, Windows has a viable free path for OSS projects through SignPath Foundation.

Background

SignPath Foundation provides free code signing certificates for qualifying open-source projects:

  • Certificate issued to "SignPath Foundation" (not project name)
  • Provides immediate SmartScreen reputation - no warning buildup period
  • novelWriter, a similar fiction writing application, already uses SignPath successfully

Eligibility Requirements

Kindling meets all requirements:

  • ✅ OSI-approved license (MIT)
  • ✅ No proprietary code components
  • ✅ Fully automated builds via GitHub Actions
  • ✅ Binary verifiably built from source
  • ✅ Actively maintained with verifiable reputation

Implementation

Phase 1: Application

  1. Apply at signpath.io for the OSS program
  2. Provide GitHub repository URL and project information
  3. Wait for approval (typically 1-2 weeks)

Phase 2: Integration

  1. Integrate SignPath into .github/workflows/release.yml
  2. Configure signing as part of the Windows build matrix
  3. Test that signed builds eliminate SmartScreen warnings

Phase 3: Attribution

  1. Add to README or download page: "Code signing on Windows sponsored by SignPath.io, certificate by the SignPath Foundation"
  2. Update installation docs to remove SmartScreen bypass instructions for signed releases

User Impact

  • Before: Users see scary "Windows protected your PC" warning, must click "More info" → "Run anyway"
  • After: Silent installation with no security warnings

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    buildBuild system and CI/CDenhancementNew feature or requestgithub_actionsPull requests that update GitHub Actions codeplatform: windowsWindows-specific

    Projects

    Status

    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions