Architecture

Direct enough to use.
Documented enough to inspect.

Pastey combines local encrypted payload storage, UDP LAN discovery, temporary HTTP transfer endpoints, and a binary chunk transport.

01

Discover

Nearby devices advertise and discover active sessions on the same LAN. An 8-digit room code remains the manual fallback.

02

Encrypt

Text becomes bytes. Files and images remain generic binary data. Payload encryption and decryption happen locally.

03

Schedule

A frontend-owned weighted scheduler plans queued file-like transfers while keeping each transfer on the established single-file path.

04

Transfer

Binary-v1 encrypts, chunks, streams, acknowledges, and finalizes files over the local peer endpoint. JSON/base64 remains a compatibility fallback.

Current boundaries

Clear about what exists now.

Implemented: encrypted local storage, LAN discovery, nearby join, binary-v1 transfer, compatibility fallback, and validation tooling.

Experimental or diagnostic: planner shadow diagnostics and broader device-capability work.

Not current: cloud relay, remote storage, backend-owned scheduling, bundle transfer, binary-v2, or substream multiplexing.