Bindings to the save-dweb-backend for the Save Android app.

• Install the Android SDK and Android Platform 34
• Install android NDK on your system
• Install Rust
• cargo install cargo-ndk
• Have save-android set up in the parent folder
• Set up the ANDROID_NDK_HOME variable
• ./build-android.sh
• You can now recompile the android app.

Tests use cargo-nextest with retries and timeouts (see nextest.toml). Veilid/DHT tests can be slow and flaky; P2P tests (test_refresh_joined_group, test_replicate_group) get 15 retries to improve pass rate.

# Install nextest (once)
cargo install cargo-nextest --locked

# Run all tests (retries from nextest.toml; no --retries to avoid overriding P2P overrides)
RUST_MIN_STACK=8388608 cargo nextest run --test-threads=1 --no-fail-fast

To run in the background and inspect later: RUST_MIN_STACK=8388608 cargo nextest run --test-threads=1 --no-fail-fast 2>&1 | tee test_output.log

Veilid upgrades are coordinated across sibling repositories in dependency order: veilid-iroh-blobs -> save-dweb-backend -> save-rust.

Use the repo-local runbook before changing Veilid or related fork pins: .claude/skills/veilid-upgrade/SKILL.md.

The Save-Rust API provides HTTP endpoints for managing groups, repositories, and media files. For detailed API documentation including request/response schemas and error handling, please see API.md.

• GET /status - Returns the server status and version.
• GET /health - Returns the server health status.
• POST /api/memberships - Joins a group.

Base path: /api/groups

• GET / - Lists all groups.
• POST / - Creates a new group.
• POST /join_from_url - Joins a group using a URL.
• GET /{group_id} - Retrieves a specific group by its ID.
• DELETE /{group_id} - Deletes a group by its ID.
• POST /{group_id}/refresh - Refreshes a group by its ID.

Base path: /api/groups/{group_id}/repos

• GET / - Lists all repositories within a group.
• POST / - Creates a new repository within a group.
• GET /{repo_id} - Retrieves a specific repository within a group.

Base path: /api/groups/{group_id}/repos/{repo_id}/media

• GET / - Lists all files in a repository.
• POST /{file_name} - Uploads a file to a repository.
• GET /{file_name} - Downloads a specific file from a repository.
• DELETE /{file_name} - Deletes a specific file from a repository.

For detailed information about request/response formats, error handling, and examples, please refer to the API Documentation.