📖 About Snapx

<br>

| Build server | Platforms | Build status | | -------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | Github Actions | linux-x64, linux-arm64, win-x86, win-x64 | Branch: develop | | Github Actions | linux-x64, linux-arm64, win-x86, win-x64 | Branch: master |

snapx is a powerful xplat .NET application with built-in support for delta updates, release channels (test, staging, production) and automatic deployment using GitHub Actions. Updates can delivered via NuGet or network share (UNC).

[!WARNING] Snapx is now considered deprecated and should be treated as maintenance-only. New projects should prefer Surge, and existing Snapx users should consider planning a migration to Surge over time. New feature investment is expected to happen in Surge rather than Snapx.

Sponsors

Package repository hosting is graciously provided by Cloudsmith. Cloudsmith is the only fully hosted, cloud-native, universal package management solution, that enables your organization to create, store and share packages in any format, to any place, with total confidence.

🚀 Getting Started Guide

Checkout our sample application, snapx demoapp. It features an xplat application (Windows and Ubuntu) that supports automatic release deployment using GitHub Actions.

Showcase

What does the installer look like?

<img src="https://media.githubusercontent.com/media/fintermobilityas/snapx/develop/docs/snapxinstaller.gif" width="794" />

Available commands

Local development requirements

Build requirements

Linux

• Docker >= 19.03.8
• GitVersion dotnet tool update gitversion.tool -g
• Powershell v7 dotnet tool update powershell -g
• .NET SDK v6.0
• .NET SDK v8.0
• .NET SDK v9.0

Windows:

• Docker Desktop >= v4.0.1

• GitVersion dotnet tool update gitversion.tool -g

• Powershell v7 dotnet tool update powershell -g

• .NET SDK v6.0

• .NET SDK v8.0

• .NET SDK v9.0

• Visual Studio 2022 Community Edition with C++ workload installed

Bootstrap snapx

Before you can open src\Snapx.slnx in Visual Studio you must bootstrap dependencies. Run init.ps1 and all dependencies will be built in Debug and Release mode.

.NET frameworks supported

• .NET 6.0 LTS
• .NET 8.0 LTS
• .NET 9.0

Platforms supported

• Windows x86/x64

  • Windows 7 SP1
  • Windows Vista SP 2
  • Windows 8.1
  • Windows Server 2008 R2
  • Windows Server 2012 R2
  • Windows Server 2016 R2
  • Windows Server 2019 R2
  • Windows Server 2022 R2

• Ubuntu Desktop x64

  • 18.04
  • 20.04
  • 22.04
  • 24.04

• Ubuntu Server x64

  • 18.04
  • 20.04
  • 22.04
  • 24.04

• Ubuntu Desktop arm64

  • 18.04
  • 20.04
  • 22.04
  • 24.04

• Ubuntu Server arm64

  • 18.04
  • 20.04
  • 22.04
  • 24.04

• Raspberry Pi OS arm64

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the Code of Conduct.

License

Snapx is under the MIT license. See the LICENSE for more information.