ZapbirdDocs

Connect your phone

Pair with a QR code, a typed address or a link, and approve your project.

When you run zapbird start, the terminal prints a QR code. Open Zapbird on your phone, scan it, and approve the project. Keep the phone and the computer on the same network.

Terminal
$ zapbird start

#Scan the QR code

The QR code carries the server address and a secret. The phone shows the project name and asks you to approve it. Each phone that connects is printed in your terminal.

#Type the address instead

If you cannot scan, choose Enter link in the runner and type the address shown in the terminal. The phone then shows a 6-digit code. Type that code in the terminal to allow the phone, or type n to refuse it.

#How long it works

  • The QR code and link work for 24 hours while the server runs, also after you close and reopen the runner.
  • Change that with --qr-hours (1 to 24).
  • Type p and press Enter for a new QR code. The old one stops working.
  • Start with --single-use-qr to make the code work only once.

#Run a full Flutter app

In the runner Settings, turn on Trusted Flutter apps. Only run projects from your own trusted computer.

#Open a recent project

The Home screen keeps your last ten projects. Tap one to open it. If the server is off, the runner asks for a fresh QR code. Clear removes the list.

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