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
| Part | Runs on | Talks to |
|---|---|---|
| zapbird and the runner SDK | Your computer | Your phone, over your local network or Tailscale. It also contacts the SDK download host when you install or upgrade an SDK. |
| Zapbird runner | Your phone | The 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 inlib/. - Values you pass with
--dart-defineare 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
| Where | What | How long |
|---|---|---|
| Your computer | The command and the runner SDKs, in ~/.zapbird (or ZAPBIRD_HOME). | Until you remove them. |
| The runner on your phone | Pairing 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
| Control | Effect |
|---|---|
--qr-hours <1-24> | How long the QR code and link work. Default: 24. |
--single-use-qr | The QR code and link work only once. |
--no-tailscale | Do 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. |