RustFS Launcher

A Tauri + Leptos application for launching RustFS.

Prerequisites

• Rust
• Node.js
• Trunk - Install with cargo install trunk

Building

Before building the application, you need to download the required RustFS binary for your platform:

On macOS/Linux:

# Download binary for current platform
./build.sh

# Build for development
cargo tauri dev

# Build for production
cargo tauri build

On Windows:

# Download binary for current platform
build.bat

# Build for development
cargo tauri dev

# Build for production
cargo tauri build

The build script will automatically detect your platform and download the appropriate binary:

• macOS Apple Silicon: rustfs-macos-aarch64
• macOS Intel: rustfs-macos-x86_64
• Windows x86_64: rustfs-windows-x86_64.exe

This approach reduces download time and storage space by only downloading the binary needed for your current platform.

Development Workflow

Pre-commit Checks

Before committing your code, run all CI checks locally:

make pre-commit

This will run:

• Code formatting check (cargo fmt)
• Clippy linter (cargo clippy)
• Frontend build (trunk build)
• Unit tests (cargo test)

Individual Checks

make check-fmt      # Check code formatting
make check-clippy   # Run Clippy linter
make check-frontend # Build frontend
make check-test     # Run tests
make fix-fmt        # Auto-fix formatting
make check-upstream # Check for new upstream rustfs/rustfs versions

Automated Upstream Sync

The project automatically syncs with upstream rustfs/rustfs releases:

• Daily Check: A scheduled GitHub Actions workflow runs daily at UTC 6:00 (Beijing 14:00) to check for new versions
• Automatic Build: When a new version is detected, the workflow automatically creates a git tag and triggers the build process
• Manual Check: Run make check-upstream locally to check for new versions
• Manual Trigger: Can be manually triggered via GitHub Actions if needed

This ensures the launcher always stays up-to-date with the latest RustFS releases without manual intervention.

CI/CD

The project uses GitHub Actions for continuous integration and automated releases. See .github/ACTIONS.md for details.

For local testing of GitHub Actions workflows, see .github/TESTING.md.

Recommended IDE Setup

VS Code + Tauri + rust-analyzer.