Files
meshcore-open/documentation/offline-mode.md
T
zjs81 462159e803 Tester feedback: offline mode, pt-PT, menus, layout and translations
Offline (read-only) mode
- The last connected radio is remembered; with no radio the app opens on
  its saved contacts, channels, messages and unread counts.
- Main screens stay open on disconnect. A Connect button replaces the
  battery and signal indicators, with a sheet to reconnect, choose a
  radio or stop a pending reconnect.
- While disconnected everything is read-only: the composer becomes a
  "connect to send" bar (drafts kept) and controls that change the radio
  or stored history are disabled or hidden.
- Resending while disconnected no longer deletes the message; a
  different radio no longer shows the previous radio's channels.
- Notification taps open the saved chat while offline.

Chats and menus
- Channel chat menu: notifications, edit channel, delete channel; the
  filter row lines up with the others; bell moved out of the app bar.
- DM and room menus: remove from contacts; rooms get room management.
- Search field uses the full app bar; long-press a result to copy.
- Hashtag channel titles no longer read "# #name"; more room around the
  radio activity dot.
- Repeat filter: short messages from one sender are caught at the same
  count as long ones.

Layout
- Shared menu row (wraps to two lines) and segment label (never splits
  a word) used across the app.
- One Scan button on the scanner; consistent settings tile titles;
  contact "last seen" wraps instead of truncating; unfetched repeater
  settings are dimmed.

Localization
- New European Portuguese locale (pt_PT); regional locales are handled
  by the language picker, notifications and the background service.
- Fill 67 missing strings per locale, including backup and restore.
- Keep "Flood" and "Zero Hop" untranslated, shorten "last seen" and
  routing labels, and fix mistranslated scan, theme and hop strings.
- Received-image strings, badge and caption come from translations.
- Regenerate the Czech localizations, which were missing strings.

Docs
- Add documentation/design.md (UI reference) and offline-mode.md;
  update channel, chat, navigation and scanner docs.
2026-11-09 21:18:29 -07:00

3.2 KiB

Offline Mode

When no radio is connected, the app keeps showing the last radio you connected to, read-only.

What you see

  • Launch. If a radio has connected before, the app opens on Channels instead of the scanner. With no remembered radio it opens on the scanner, as before.
  • Contacts, channels, messages, unread counts and the map show that radio's saved data. Chats open, scroll, search and jump as usual.
  • App bar. The battery and signal indicators are replaced by a Connect button (icon only on narrow screens). The subtitle reads "Offline · radio name". While the app is connecting, or a dropped link will be retried, a "Reconnecting…" chip shows instead; tapping it opens the same sheet.
  • Message box. Each chat replaces the message box with "Connect to a radio to send messages" and a Connect button. Text you typed before the link dropped is kept and comes back when the radio reconnects.

Connecting

The Connect button and the overflow menu's Connect entry (it replaces Disconnect while offline) open a sheet with:

  • Reconnect to name. For a Bluetooth or TCP radio. It connects directly, without the scanner. Not offered on web.
  • Choose a radio. Opens the scanner (Bluetooth, USB or TCP). For a USB radio, or on web, it opens the USB screen.
  • Stop reconnecting. Shown while an automatic reconnect is pending.

After a connection made from the scanner, USB, TCP or review mode, the app shows Channels as its only screen. Reconnecting from the sheet keeps you on the screen you were on.

Disconnect asks for confirmation and then leaves you on the same screen, offline. The app no longer returns to the scanner when a radio disconnects.

What is available offline

Available: reading, scrolling, opening chats, search and jump, copy, message details and paths, path maps, translating a message for reading, notification mode, chat background, text size, channel region labels, contact groups, app settings, message filter settings, themes and language.

Unavailable (shown disabled or hidden):

  • Sending: messages, reactions, replies, resend, GIFs, images, location and contact sharing, map pins.
  • Channels: add, edit, delete, join or leave a community, pull to refresh.
  • Contacts: add (clipboard, QR, discovered), remove, favourite, share, adverts, path trace, forget path, discovered-contact import/export and delete.
  • Repeaters and rooms: login, management and telemetry. Tapping a room opens its saved chat without a login, read-only.
  • Region fetching, radio settings and other radio commands in Settings.
  • Changing stored history: clear chat, delete messages, bulk delete, mark spam / not spam.

Routing overrides in the routing sheet can still be chosen offline; they are saved on the phone and used on the next send ("Path saved locally").

Notes

  • Notification taps open the saved chat even while offline.
  • Only one radio is remembered: the last one that completed a connection. Review mode never replaces it, and the remembered radio's data is shown again when a review session ends.
  • Connecting to a different radio replaces the shown data with that radio's.
  • The remembered radio is stored in the app-wide preference last_radio.
  • USB radios cannot be reconnected from the sheet; use Choose a radio.