Toss Documentation
Toss Documentation
Section titled “Toss Documentation”Securely share your clipboard across all your devices
Welcome to the Toss documentation! Toss is a cross-platform clipboard sharing application with end-to-end encryption that allows you to copy on one device and paste on another - securely and instantly.
Quick Links
Section titled “Quick Links”- Quick Start Guide - Get started in minutes
- Installation - Install Toss on your platform
- User Guide - Learn how to use Toss
- Developer Guide - Build and contribute
Features
Section titled “Features”- End-to-End Encryption: All clipboard data is encrypted using AES-256-GCM before leaving your device
- Cross-Platform: Works on macOS, Windows, Linux, iOS, and Android
- Local-First: Direct peer-to-peer sync on local networks for minimal latency
- Relay Fallback: Cloud relay server for syncing when devices aren’t on the same network
- Multiple Content Types: Supports text, images, files, and URLs
- Easy Pairing: QR code or 6-digit code for secure device pairing
- Privacy Focused: Zero-knowledge architecture - relay servers can’t read your data
Project Status
Section titled “Project Status”✅ MVP Implementation Complete (2024-12-19)
🎉 All 26 planned MVP features implemented (81.3% of total items)
- ✅ Platform-specific structures for all target platforms
- ✅ Testing infrastructure and CI/CD pipelines ready
- ✅ FFI configuration and verification complete
- ✅ Comprehensive documentation
See Project Status for more details.
Getting Started
Section titled “Getting Started”- Install Toss on your platform
- Pair your devices using QR code or 6-digit code
- Start syncing - copy on one device, paste on another!
Documentation Structure
Section titled “Documentation Structure”For Users
Section titled “For Users”- Quick Start - Get up and running quickly
- User Guide - Learn how to use Toss
- Pairing Devices - Connect your devices
For Developers
Section titled “For Developers”- Architecture - System design and architecture
- API Reference - API documentation
- Platform Support - Platform-specific details
- Testing - Testing guide
Platform-Specific
Section titled “Platform-Specific”- macOS - macOS implementation details
- Windows - Windows implementation details
- Linux - Linux implementation details
- iOS - iOS implementation details
- Android - Android implementation details
Contributing
Section titled “Contributing”- Contributing Guide - How to contribute
- Code of Conduct - Community standards
- Security Policy - Security reporting
Security
Section titled “Security”Toss takes security seriously:
- X25519 key exchange for secure device pairing
- AES-256-GCM authenticated encryption for all data
- Ed25519 signatures for device identity
- Zero-knowledge relay: The relay server only sees encrypted blobs
- Forward secrecy: Session keys are rotated regularly
See Security Policy for more information.
License
Section titled “License”Toss is open source software licensed under the MIT License.
Acknowledgments
Section titled “Acknowledgments”Built with:
- Rust - Core library
- Flutter - Cross-platform UI
- Quinn - QUIC implementation
- flutter_rust_bridge - Rust/Dart FFI