On your phone
Look at a board from your phone while the computer builds it. Scan the QR code the server prints, and accept the certificate warning once.
Getting in
- Run
soldermask serveon the computer. It prints a QR code. - Scan the QR code with your phone. It opens the app and logs the phone in.
- Accept the certificate warning. On iOS, tap Show Details, then visit this website. The phone asks only once.
The QR code carries https://<lan-ip>:8443/?token=<access token>. The app swaps
the token for a cookie and removes it from the address bar. Without the token,
every device except the computer itself sees the login page. See
Access control.
No QR code in the terminal
The QR code needs the qrcode package. A checkout's .[all] has it. A
tool install needs --with qrcode (see Install). Without it,
open the printed address on the phone and type the printed access token.
Why HTTPS on a home network
Tilt orbits the 3D board as you move the phone. Browsers give a page
the phone's orientation only over HTTPS. So soldermask serve makes a
self-signed certificate for the computer's network address, and serves
HTTPS by default. --http turns HTTPS off, and Tilt with it.
{ width="320" }
The phone layout
The board takes the whole screen. The header and the verdict float over its top, and one row of buttons sits at thumb height.
| Control | Where | Does |
|---|---|---|
| Verdict pill | Under the header | Says GO or NO-GO and what holds. Tap it for the reason. |
| Layers | Beside the pill | Opens the layer toggles as a card |
| Chat | Thumb row, left | Slides the thread up as a full sheet |
| View switcher | Thumb row, middle | Switches between Copper, 3D and Schematic |
| Details | Thumb row, right | Opens the details sheet on its first tab. That tab is Board, saying what holds the board, or the picked part, named by its reference. The other tabs are Findings, Chain, Scope and Cost. The button reads Close while the sheet is open. |
| Rebuild | Over the thumb row | Appears after you move a part. It says what changed. |
| Tilt | Over Chat, 3D view only | Orbits the board as you tilt the phone, starting from however you hold it. |
Two devices, one board
A phone and a computer looking at the same project stay in step. They share the view, the 3D camera, the picked part, the isolated net, the quantity and the version. The last move wins, and a device ignores the echo of its own moves.
You can add the app to your home screen. It ships a web manifest and an icon.