Contributing

Thanks for helping improve Athas.

Development Setup

Common Prerequisites

• Git
• Rust (via rustup)
• Node.js 18+ and bun

Platform Setup

# Install Xcode CLI tools
xcode-select --install

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install bun
curl -fsSL https://bun.sh/install | bash

brew install pkg-config

Clone and Run

git clone https://github.com/athasdev/athas.git
cd athas
bun install
bun dev

Release Packages

Debian Packages

Athas can build experimental .deb packages from a Linux checkout. The package script wraps Tauri's Linux bundler, adds the CEF runtime resources, and patches the Debian dependency list after the bundle is created.

bun install
bun build:linux:deb

The script must run on Linux. It looks for a CEF distribution containing libcef.so in CEF_PATH, .cache/tauri-cef, ~/.cache/tauri-cef, ~/.local/share/cef, or the Cargo build directories. If it cannot find CEF, set CEF_PATH explicitly or run a Linux build once to populate the local cache.

CEF_PATH=/path/to/cef bun build:linux:deb

Preview builds use the same script with the preview config:

bash scripts/release/package-linux-native.sh deb --preview

The resulting .deb file is written to target/release/bundle/deb/.