Skip to content
Parity 0.1.0
Menu

The desktop app (after 1.0)#

The app is for people who never open a terminal. It is one window over the same Go code the parity command runs: each button calls the code its command calls, and nothing in the window decides anything on its own. So the window and the command cannot disagree, and a screen always says which command it matches ("In a terminal: parity status").

Your app, up and matching#

The app's home shows one app: its state, Start or Stop (one button), Open in browser and Run test, the address, and the same side by side mirror the front page shows, one row per fact, reading "Matches Citadel." when every row does.

Parity's app with hello running: a Running, match badge, Stop, Open in browser and Run test buttons, the address http://localhost:8080, and the side by side mirror of this computer and Citadel (image, image id, PHP 8.5.12, platform, php.ini, MySQL 5.6.51, Node, PHP extensions), every row Match, ending in Matches Citadel.
The Overview tab, the same reading as parity status.

Logs#

The Logs tab is parity logs -f with a filter: all of it, or only the app, the proxy, MySQL or Parity's own lines. The local passwords Parity made for the app show as hidden, here as in the terminal.

Parity's app, the Logs tab for hello: buttons to show all lines or only app, proxy, mysql or parity lines, a line filter and a Follow switch, a note that Parity hides the local passwords it made for the app, and sixteen log lines with the time and the source on each, one database password shown as hidden.
The Logs tab, following as new lines arrive.

parity.json, without a text editor#

The parity.json tab sets what the file sets: how sign-in works here (none, SESAME's fake sign-in, or Wayne State CAS as on Citadel), and the cron entries Citadel runs in the app container. The whole file sits under it, to read or copy; the parity.json reference covers every key.

Parity's app, the parity.json tab for hello: a sign-in card with three choices (no sign-in, fake sign-in with SESAME, selected, signed in as jdoe, and Wayne State CAS), a cron entries card with nightly-report at 30 2 * * * running php bin/report.php and a form to add one, and the start of the parity.json file below.
The parity.json tab, writing the same file you can edit by hand.

The rest#

  • Check this computer is the first screen: the same checks as parity check.
  • Add an app proposes the parity.json parity init would write and writes nothing until you say so.
  • Settings picks the engine (Docker or Podman), checks the ports, and gets or verifies Citadel's images with the same steps as parity image get and parity image verify.
  • Ctrl K lists every command, each with the parity command it matches.

The front page shows each of these next to its terminal printout: Check, then up.