← Dashboard · Docs ·Sharing

Sharing in Grove

Overview

Grove sharing is peer-to-peer and cryptographic. When you share a file, you create a signed grant that gives the recipient permission to decrypt and access it. No central server involved.

How It Works

Sharing a File

1. You select a file in the Files tab and click 🔗 Share

2. A modal shows your friend peers (non-friends can't receive shares)

3. Select recipients and click Share

4. For each recipient, Grove:

Receiving a Shared File

1. Grant arrives at your cell and is verified (Ed25519 signature check)

2. File appears in your Feed tab

3. If chunks are already on your cell → file is immediately viewable

4. If not → shows as "☁️ Remote" with a 📡 Fetch button

5. Click Fetch to download chunks from the sharer (or any peer holding them)

Unsharing

1. Click 🔓 Unshare on a shared file

2. Select which peers to revoke

3. Grant is deleted from their cell via POST /api/revoke-grant

4. They lose access (though they may retain already-downloaded chunks)

Folder Sharing

Auto-Share Folders

When sharing a folder, you can enable auto-share:

Batch Sharing

Select multiple files with checkboxes → batch share to same recipients.

Grant Structure


{
  "manifest_hash": "sha256_of_manifest_content",
  "filename": "vacation.jpg",
  "file_type": "image",
  "total_size": 4521984,
  "encrypted_file_key": "base64_encrypted_key",
  "creator_pubkey": "base64_ed25519_pubkey",
  "recipient_pubkey": "base64_ed25519_pubkey",
  "signature": "base64_ed25519_signature",
  "granted_at": "2026-03-28T15:00:00",
  "thumbnail": "base64_jpeg_thumbnail_or_null",
  "source_peers": ["pubkey1", "pubkey2"]
}

Verification

Feed Views

Gallery View (default)

List View

Toggle between views with 🖼️ / 📋 buttons. Preference saved.

Security Notes

Tips