←All projects

Dynamo

A desktop bench app for the Wise Water factory. It takes a bare ESP32 board out of the box, gives it an identity, flashes its firmware, prints its label, and puts it on Wi-Fi, all without a terminal.

✦ Designed & built by me

Role
Design & development
When
2026
Type
Desktop app for hardware

FlutterDartRiverpodESP32Bluetooth LEPython

Available on

  • macOS
  • Windows
  • Linux

Take it for a spin

A copy of the app, screen for screen. Plug the board in under the window, then flash it: pick the device type, its record and a build. Or erase it back to factory state, and see every change in the history.

The product

Every Wise Water controller starts life as a bare ESP32 board. Before it can go into a water treatment unit, it needs an identity burned into its flash, the right firmware, a label on the case and a Wi-Fi network. That used to be a pile of shell scripts: esptool, an NVS partition generator, a SPIFFS builder and a serial monitor, all run by hand.

Dynamo replaces all of it with one desktop app for macOS, Windows and Linux. An operator logs in, plugs a board in, and the screen turns into that board's live surface. Initialize, install, update, roll back, erase, print the label, done.

I designed and built it from scratch: about 37,000 lines of Dart across 270 files.

Designed by me

I designed Dynamo end to end, not just built it. The brief to myself: a factory tool that feels like a native Mac app on macOS, Windows and Linux alike, and that an operator can use all day without reading a manual.

  • Its own design system. Every colour, radius, spacing step and duration is a token. There is a catalogue of D* widgets: buttons, inputs, glass header, status beacon, tooltips, stage badges. The app uses Cupertino widgets only, no Material, ever.
  • One spinner. The logo bolt "charging" in place is the only loading indicator anywhere, in any size.
  • States you can read from across the room. An empty bench, a busy port and a failed connection each get their own full-screen beacon, not a toast.
  • Colours that mean the same thing everywhere. A board's stage (new, flashed, warehouse, active) uses the admin hub's own colours, and the stage is always written next to its colour, never replaced by it.
  • One family of products. Control sizes and corner radii are shared with the mobile app, so Dynamo, Orion and the phone app read as one product.
  • Beautiful, but cheap. Blurs and ambient animation are budgeted. Nothing animates while the window isn't being looked at.

The interesting parts

Plug in a cable, the app does the rest

Detecting a board sounds trivial until you do it on three operating systems and four USB-UART bridge chips. macOS pairs ioreg entries with device nodes named from a zero-stripped hex fragment of the USB location ID. Linux reads udev symlinks. Windows asks CIM for serial ports, and when the vendor driver is missing, the board is plugged in, powered and completely invisible. So on first launch Dynamo installs the missing CP210x and CH340 drivers itself.

Supporting a new board revision is one entry in a registry, not a new if in a scanner.

A toolchain the operator never sees

Flashing needs Python, esptool and Espressif's NVS tools. On first launch the splash screen resolves or installs all of it and verifies the bundled assets, so an operator never has to open a terminal or read an install guide.

Serial that doesn't lie

Serial ports are where desktop apps go to die. Dynamo streams UART through a small pyserial child process, the same library esptool uses and the one proven on these bridges in the field. It retries around the moment macOS exposes a port before its driver is ready, strips control bytes so a mis-framed line cannot inject terminal escapes into the log, and keeps a searchable transcript of up to 100,000 lines.

Busy ports, several boards on one bench, a cable pulled mid-read: each of these is its own explicit state in a sealed state machine, with its own screen, not an error toast.

Works when the office network doesn't

A bench is not idle just because the network is down. Offline, every screen keeps showing what it last knew. Only the actions that truly need the server get disabled. Writes wait in a persistent outbox and are replayed, in order, the moment the connection comes back.

Wi-Fi over Bluetooth, labels over USB

A controller that is already screwed into its case gets its Wi-Fi credentials over Bluetooth LE. It uses the same GATT contract as the mobile app, but a different plugin, because the mobile one has no free Windows support. Before a board leaves the bench, Dynamo draws its label and sends it to a wired label printer.

Next: Orion→

A calibration bench for Wise Water's osmosis controllers. It runs a controller against a reference flow meter and writes the corrected constants back, so every litre it reports is a real litre.