On your phone Docs menu

Docs

kwant on your phone

kwant has a phone app, and you don't need an app store for it. Open your kwant in Safari or Chrome on the phone, add it to the Home Screen, and it opens full screen with its own icon, like any other app. You can read what your team did, answer questions and approve actions, and get a notification when a bot needs you.

What you need

A kwant server your phone can reach over https: kwant on a VPS or with Docker, behind an HTTPS reverse proxy. Phones only install apps from https addresses.

The Mac, Linux and Windows apps run kwant at 127.0.0.1, an address only that computer can open, so a phone can't reach them. For kwant on your phone, run it on a server (the desktop app can open that server too, side by side with This Mac). With no server, you can still get your bots on Telegram.

Install it in three steps

  1. Open kwant on the phone. On a computer where you're signed in, open your kwant at its https address (not through a tunnel at 127.0.0.1, which the QR code would point to), then open Settings → All spaces → Signed-in devices → Add a phone or browser and scan the QR code with the phone's camera. It opens your kwant and signs the phone in once. Or open your server's address on the phone, tap Sign in from another device, and approve the code it shows from a device that's already signed in.
  2. Add it to the Home Screen.
    • iPhone and iPad: open it in Safari, tap Share, then Add to Home Screen, then Add.
    • Android: in Chrome, tap ⋮, then Add to Home screen (or Install app), then Install.
    On an iPhone, kwant also shows these steps once in Safari, and on Android Chrome it can offer an Install button.
  3. Open "kwant bots" from the Home Screen and turn on Settings → All spaces → Notifications → Notify me on this device. Now an approval, a question or a step only you can do reaches you even with the app closed. On an iPhone, notifications only work in the app on the Home Screen, not in a Safari tab.
The Product team summary on a phone screen.
The approval card for a GitHub pull request on a phone screen.

Updates

The app loads from your server, so there's nothing to update on the phone: when you update kwant on the server, the phone has the new version the next time it opens.

What it does on a phone

  • Chats list who needs you first, one tab at a time, full width.
  • Approvals and questions come as cards you answer with a tap.
  • Notifications open the right chat, and name the space when you have more than one.
  • Signed-in devices in settings lists the phone, so you can sign it out from any other device.

If it doesn't install

  • No Add to Home Screen, or no notifications: the address must start with https://. A plain http:// address or a network address like 192.168.1.20:8799 opens, but the phone won't install it.
  • On an iPhone, the option is missing: use Safari. Some other browsers on iOS, and apps that open links inside themselves, can't add to the Home Screen.
  • The QR code expired: each one works once, for 15 minutes. Make a new one.