Building from Source

Requirements

JDK 25+
Gradle 9+ (or use the included ./gradlew wrapper)

Clone and run

git clone https://github.com/Kitty-Hivens/Nexira.git
cd Nexira

# Run in development mode
./gradlew :client-ui:run

# Run tests
./gradlew :client-core:test :client-launcher:test

Build release artifacts

# Windows — distributable folder (fed into Inno Setup)
./gradlew :client-ui:createReleaseDistributable

# macOS — DMG
./gradlew :client-ui:packageReleaseDmg

# Linux — uber JAR (AppImage is assembled manually in CI)
./gradlew :client-ui:packageReleaseUberJarForCurrentOS

CI / Release pipeline

Releases are built automatically by .github/workflows/build_release.yml on tag push (v*.*.*).

The pipeline:

Runs tests — build fails if any test fails
Builds Windows EXE (Inno Setup), Portable ZIP, Linux AppImage, macOS DMG in parallel
Generates SHA256 checksums
Publishes a GitHub Release with changelog extracted from CHANGELOG.md

Platform notes