Skip to content

PWA Walkthrough

Ravi Singh edited this page Jul 19, 2026 · 4 revisions

PWA Walkthrough

The TankSync™ PWA at tanksync.smartghar.org is the cloud-side companion to the hub's local web UI. One URL, any browser, installs as a phone app if you want, reachable from anywhere — no port forwarding, no VPN.

Auth: account-based. One account can own multiple hubs and is shareable with family. Theme: auto (follows time of day), can be overridden in Settings.


Dashboard — the home view

Light + dark themes side-by-side (the PWA auto-picks based on time of day):

Dashboard — light theme Dashboard — dark theme

Every paired tank from every hub on your account shows up as a card with current level, capacity, signal, last-seen, and battery health. Tap a card to drill in.

When a tank reports a sensor problem (variance-based "sensor stuck" detection), a warning chip bubbles to the home screen — no need to dig into settings:

Dashboard — sensor stuck warning chip


Tank detail — drill in

Per-tank views show power telemetry (left) and history graphs over multiple time windows (right):

Tank detail — power telemetry from INA219 Tank detail — battery history + read-only settings

History data retention: 90 days on the free tier, 1 year on Pro.


Alerts feed

Bottom-nav middle button. Reverse-chronological, filterable by category (All / Water / Battery / Device). Light + dark variants:

Alerts feed — light Alerts feed — dark

Mark all read clears the badge on the bottom-nav. Alerts include: overflow risk, critically low battery, large drop (possible leak), tank completely empty, sensor errors.


Settings — profile, plan, hub config

Top of Settings: profile + plan card (left). Hub list with LED strip + buzzer config (right):

Settings — profile + plan Settings — hub list + LED + buzzer

Lifetime Pro is bundled with TankSync kits purchased from SmartGhar. Independent builds use the free tier (still covers 3 hubs / 6 tanks).

Scrolling further down Settings: support / notifications / appearance (left), local-network + firmware + about in dark theme (right):

Settings — support, notifications, appearance Settings — local network + firmware + about (dark)

Same bottom section in light theme (the auto-theme switches at sunrise / sunset):

Settings — local network + firmware + about (light)


Firmware updates

The Firmware page lists hub + all paired transmitters with their current versions and any available updates. Status + manual upload paths side-by-side:

Firmware update page Firmware update — manual .bin upload

If a transmitter has an update available, an UPDATE AVAILABLE · vX.Y.Z button appears. Tapping it triggers the remote OTA over LoRa — the hub orchestrates it and pushes the new binary to the TX across the LoRa link. No cable, nothing to climb to; it's slow (~8–10 min per TX) but hands-off.

Prefer to update a transmitter locally? Put it into Wi-Fi AP mode — hold the TX's BOOT button >5 s after a reset — connect to its TankSync-TX-XXXX hotspot, and flash it (and read its diagnostics) from there. So there are two TX update paths: remote over LoRa (this button) and local over Wi-Fi (the TX's own AP).

The manual .bin upload route is for custom builds — most users never use it.


Installing the PWA as a phone app

  • iOS Safari: Share → "Add to Home Screen"
  • Android Chrome: menu → "Install app"

Once installed, TankSync looks and feels like a native app — same icon on your home screen, no browser chrome, push notifications work natively. No App Store, no review delay.


What the PWA doesn't do (deliberately)

  • No Wi-Fi credential changes — chicken-and-egg. If the hub is on the wrong Wi-Fi, the PWA can't reach it. Use the hub's setup-mode AP for that.
  • No LoRa frequency / hub address changes — same. Local web UI only.
  • No factory reset — local web UI + physical button only. Avoids "I clicked the wrong thing on my phone and now my hub is gone."

For everything else, the PWA is parity with the local web UI plus history + sharing on top. See Local Web UI for the LAN-only side.

Clone this wiki locally