From bdf957514c092d59d9cbbbc5e5801c200a299568 Mon Sep 17 00:00:00 2001
From: Jannis Braun <151788261+TheZwiss@users.noreply.github.com>
Date: Wed, 1 Jul 2026 01:15:33 +0200
Subject: [PATCH] docs: accurate read-state wording + mobile/PWA and
 app-store-roadmap mention

- Features list: 'read states' -> 'unread tracking (badges + unread divider)',
  which is what the code actually does (no read receipts).
- Clarify the PWA bullet (add-to-home-screen standalone app) and the
  mobile-responsive touch layout.
- Add a Mobile section: working mobile-browser/PWA today, native iOS/Android
  app-store apps planned once traction and license funding are secured.
---
 README.md | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 779c1a28..5f743641 100644
--- a/README.md
+++ b/README.md
@@ -87,7 +87,7 @@ inside a business — but not to resell as a hosted service. See
 - DM voice/video calls with ring / accept / reject
 - Message reactions, replies, editing, and deletion
 - Markdown formatting with syntax highlighting
-- Typing indicators, read states, and presence
+- Typing indicators, unread tracking (badges and an unread divider), and presence
 - Rich link embeds (YouTube, Vimeo, Spotify, and generic OpenGraph) with SSRF-protected scraping
 - GIF search (Klipy)
 
@@ -127,8 +127,8 @@ inside a business — but not to resell as a hosted service. See
 - Automatic SQLite backups (pre-migration, scheduled, and manual) with restore tooling
 - Electron desktop app (Windows, macOS, Linux) with global keybinds (push-to-talk, mute, deafen) and activity detection
 - Native desktop notifications and unread badge counts
-- Installable PWA — service-worker caching and an offline message queue (messages send once you reconnect)
-- Mobile-responsive web UI
+- Mobile-responsive web UI with a dedicated touch layout (bottom navigation, swipe gestures, full-screen views)
+- Installable PWA — add it to your phone's home screen to run it as a standalone app, with service-worker caching and an offline message queue (messages send once you reconnect)
 - Account management — password change and account deletion with safeguards
 
 ## Installation
@@ -310,6 +310,19 @@ pnpm build       # package for distribution
 Cross-platform builds are produced for Windows, macOS, and Linux. See
 [`docs/systems/desktop.md`](docs/systems/desktop.md).
 
+## Mobile
+
+Backspace works on mobile today — just open your instance in a phone browser.
+The UI has a dedicated touch layout (bottom navigation, swipe gestures, and
+full-screen views), and because it ships as an installable **PWA** you can use
+your browser's **Add to Home Screen** to install it as a standalone app: its own
+icon, no browser chrome, and an offline message queue that flushes when you
+reconnect.
+
+Native **iOS and Android app-store apps are planned** — once the project gains
+traction and the funding for the developer-program licenses is secured. Until
+then, the installable PWA is the supported way to run Backspace on a phone.
+
 ## Architecture
 
 Backspace is a TypeScript monorepo managed with pnpm workspaces.