FAQ
Short answers to the questions people ask first.
#Do I need Xcode or Android Studio?
No. Zapbird runs your project on the phone you already have, so there is no emulator to start, no native build to wait for and no signing to set up. You still need Flutter itself.
#Do I need an account?
No. There is no Zapbird account and no cloud service. Everything runs on your own computer and network.
#Does Zapbird send analytics?
No. Read Data and network and the Privacy Policy.
#Which Flutter version do I need?
Zapbird is built for Flutter 3.41.x (Dart 3.11). A newer Flutter writes a newer Dart version into new projects that the runner cannot compile yet. See Quick start.
#Do my phone and computer have to be on the same network?
By default, yes. With Tailscale on in both, the phone stays connected on any network. Turn that off with --no-tailscale.
#Does my source code leave my computer?
Your phone receives compiled bytecode and your assets, not your source files, unless you start with --allow-phone-edit.
#What is the difference between bytecode and kernel mode?
Bytecode needs a runner SDK and is the fast path: every save updates the phone by itself. Kernel mode needs nothing extra and runs full Flutter, and you press r to reload and R to restart. See How Zapbird works.
#What happens when the runner on my phone updates?
Run zapbird sdk upgrade to get the SDK made for the new build.
#How long does a QR code work?
24 hours while the server runs, or the time you set with --qr-hours. Type p for a new one, or start with --single-use-qr to make it work once.
#Where do I get help?
Start with Troubleshooting, then write to us from the support page.