Development notes

While developing, in one terminal:

$ make watch  # watch frontend code and print errors

And then in another:

$ ./watch   # build in a loop; restarts on changes

Now reloading the page reloads the content.

Formatter

$ make fmt

To run prettier+gofmt, which is checked on presubmit.

Protocol changes

$ make proto

Regenerates the generated protocol code.

Testing

HTML/JS-only tests are in web/src/test.ts, driving a headless Chrome:

$ cd web; npm run test

Go tests use the Go test runner:

$ cd cli; go test ./...

To bring up a test page to poke in a browser:

$ make serve

and visit http://localhost:9001/local.html.

Chrome PWA

PWAs only work on https or localhost. For one of these on ChromeOS, the best option seems to be connection forwarding using Connection Forwarder to forward localhost into the crostini IP.

Update: digging in the Chrome source suggests that on ChromeOS specifically, Chrome also treats penguin.linux.test as a trusted domain. However, I’ve never been able to make the Chrome PWA bits work on ChromeOS (localhost or penguin.linux.test) so I’ll leave the previous paragraph here until I’m confident of the resolution.

The icon

$ convert -size 32x32 -gravity center -background white -fill black label:">" icon.png

vt100

Run script then the command to capture raw terminal output.

Run infocmp -L to understand what the terminal outputs mean.

bash

To experiment with the bash completion support, run:

$ cd cli && go run ./bash/demo