Skip to content

feat: add Linux support with AppImage, deb, and rpm builds#356

Open
maxtara wants to merge 10 commits intostagingfrom
feature/linux-1
Open

feat: add Linux support with AppImage, deb, and rpm builds#356
maxtara wants to merge 10 commits intostagingfrom
feature/linux-1

Conversation

@maxtara
Copy link
Collaborator

@maxtara maxtara commented Feb 13, 2026

Summary

Adds Linux distribution builds and CI/CD pipelines for Linux support.

Changes

  • package.json: Added Linux build targets (AppImage, deb, rpm) and \dist:linux\ script
  • scripts/install-linux-deps.sh: Debian/Ubuntu dependency installer (libnss3, libasound2)
  • scripts/install-linux-deps-fedora.sh: Fedora/RHEL dependency installer (nss, alsa-lib)
  • build-pr.yml: Added Ubuntu and Fedora build jobs
  • release.yml: Added Linux build and artifact publishing
  • build-staging.yml: Added Linux dependency installation for tests
  • README.md: Added Linux download and build instructions

Testing

  • Verified on fresh Ubuntu 24.04 WSL that only \libnss3\ and \libasound2t64\ are required
  • Used \ldd node_modules/electron/dist/electron | grep 'not found'\ to validate

Related

Closes #351

- Add Linux build targets to package.json (AppImage, deb, rpm)
- Add dist:linux npm script
- Add install-linux-deps.sh for Debian/Ubuntu (libnss3, libasound2)
- Add install-linux-deps-fedora.sh for Fedora/RHEL (nss, alsa-lib)
- Update build-pr.yml with Ubuntu and Fedora build jobs
- Update release.yml to publish Linux artifacts
- Update build-staging.yml to install Linux deps for tests
- Update README with Linux download and build instructions

Tested on fresh Ubuntu 24.04 WSL - only libnss3 and libasound2 are needed.

Closes #351
Testing on fresh WSL images (Ubuntu 20.04/24.04, Fedora 42, Arch)
showed that minimal installs are missing many GUI libraries.

Updated script to include all required dependencies:
- GTK3 and related libs
- libgbm, libxkbcommon, at-spi2-core
- libxcomposite, libxdamage, libxfixes, libxrandr

Tested with npm run dev on all 4 distros successfully.
@maxtara
Copy link
Collaborator Author

maxtara commented Feb 13, 2026

tested WSL, fedora/ubuntu (2404/2004) and Arc all run. Testing VM now

@maxtara maxtara marked this pull request as ready for review February 13, 2026 08:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants