Skip to main content

Installation

Requirements​

  • .NET 10 SDK or later
  • For the editor: Windows 10+ (Linux support planned)

NuGet package (API only)​

dotnet add package SamLabs.Armatura.Core

This gives you the structural model, load system, analysis, and design code assessment — everything needed to build and analyze models programmatically.

Editor​

Download the latest release from the releases page or build from source:

git clone https://github.com/samlabs/armatura.git
cd armatura
dotnet build SamLabs.Armatura.Editor/SamLabs.Armatura.Editor.csproj
dotnet run --project SamLabs.Armatura.Editor

The editor requires OpenGL 4.6 support.

Alpha release (actual GitHub pre-release flow)​

This repository includes a GitHub Actions workflow that builds and publishes an alpha zip asset automatically when you push an alpha tag.

git checkout main
git pull
dotnet publish SamLabs.Armatura.Editor/SamLabs.Armatura.Editor.csproj \
  -c Release \
  -r win-x64 \
  --self-contained true \
  /p:PublishSingleFile=true \
  /p:IncludeNativeLibrariesForSelfExtract=true

Output folder:

SamLabs.Armatura.Editor/bin/Release/net10.0/win-x64/publish/

Trigger an actual alpha release:

git tag v0.1.0-alpha.1
git push origin v0.1.0-alpha.1

What happens next:

  1. .github/workflows/alpha-release.yml runs on the tag.
  2. It publishes SamLabs.Armatura.Editor for win-x64 as self-contained.
  3. It zips the publish output.
  4. It creates/updates a GitHub Pre-release and uploads the zip asset.
  5. Share that release URL with your friend.

You can still use the local dotnet publish command above for testing the build before creating the tag.