soldermaskdocs

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

  1. Run soldermask serve on the computer. It prints a QR code.
  2. Scan the QR code with your phone. It opens the app and logs the phone in.
  3. 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.

The phone layout: the board full-bleed, chrome floats, details appear when you pick a part{ 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.

ControlWhereDoes
Verdict pillUnder the headerSays GO or NO-GO and what holds. Tap it for the reason.
LayersBeside the pillOpens the layer toggles as a card
ChatThumb row, leftSlides the thread up as a full sheet
View switcherThumb row, middleSwitches between Copper, 3D and Schematic
DetailsThumb row, rightOpens 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.
RebuildOver the thumb rowAppears after you move a part. It says what changed.
TiltOver Chat, 3D view onlyOrbits 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.

On this page