ZapbirdDocs

Data and network

Exactly what runs where, what travels between your computer and your phone, and what is stored.

This page is for teams that need to know what Zapbird touches before they allow it. It describes the same behavior as Security, organised by what moves and what stays.

#What runs where

PartRuns onTalks to
zapbird and the runner SDKYour computerYour phone, over your local network or Tailscale. It also contacts the SDK download host when you install or upgrade an SDK.
Zapbird runnerYour phoneThe zapbird server you paired with. Nothing else.

#What travels to the phone

  • Compiled bytecode and your assets, such as images and fonts.
  • Not your source files, unless you start with --allow-phone-edit, which reaches only the Dart files in lib/.
  • Values you pass with --dart-define are compiled into the app, so pass only keys that are safe in an app.

#How the connection is protected

  • The server makes a new TLS certificate each time it starts.
  • The QR code carries that certificate and the phone trusts only it, so another computer on the network cannot pose as yours.
  • The server accepts only local addresses.
  • Pairing needs the secret in the QR code or link, or a 6-digit code you type in the terminal.

#What is stored

WhereWhatHow long
Your computerThe command and the runner SDKs, in ~/.zapbird (or ZAPBIRD_HOME).Until you remove them.
The runner on your phonePairing details are kept in memory. The Home screen lists your recent projects for the current session.The session. Clear removes the list.
Zapbird (the company)Nothing about your project. We receive only what you send us when you write to support.See the Privacy Policy.

#Downloads

The published SDK list is signed by the publisher, and a list whose signature does not check is not used. Every download is checked against its checksum, and every file in it against the hashes inside, before anything is installed.

#Controls you have

ControlEffect
--qr-hours <1-24>How long the QR code and link work. Default: 24.
--single-use-qrThe QR code and link work only once.
--no-tailscaleDo not also serve on this computer's Tailscale address.
--host <ip>Serve on one network address you choose.
--session-seconds <1-900>How long a phone session lasts before it renews. Default: 900.

Was this doc helpful?

Zapbird sends no analytics. Read about security.

Flutter and the related logo are trademarks of Google LLC. Zapbird is not endorsed by or affiliated with Google LLC.

esc