Skip to content

Installed app: home-screen shortcuts that open the scanner directly #577

Open

Description

@strausmann

What you're trying to do

Open Kept on the phone straight into the code scanner, e.g. standing at a shelf with a labelled box in hand, without first going through Start.

What gets in the way today

The installed app always starts on /. Long-pressing its icon on Android shows only the browser's own entries ("Site settings"), because apps/web/public/manifest.webmanifest declares no shortcuts. Reaching the scanner takes an extra screen every time.

What you'd like

Web app manifest shortcuts for the scanner, using the routes that already exist:

"shortcuts": [
  { "name": "Scan", "short_name": "Scan", "url": "/scan",
    "icons": [{ "src": "/shortcut-scan-96.png", "sizes": "96x96", "type": "image/png" }] },
  { "name": "Scan session", "short_name": "Scan session", "url": "/scan-session",
    "icons": [{ "src": "/shortcut-scan-session-96.png", "sizes": "96x96", "type": "image/png" }] }
]
  • A long-press on the app icon then offers Scan and Scan session. On Android a shortcut can be dragged out of that menu onto the home screen, which gives a separate "Kept – Scan" icon that opens the scanner directly.
  • The shortcut names come from the manifest, so a translated name per language would need the manifest localised or the English names kept short and neutral.
  • Unauthenticated starts keep the normal sign-in flow and land on the scanner afterwards.

Related: #575 (scan the target place in the move sheet).

Activity

  1. strausmann commented on Nov 18, 2026

    @strausmann
    ContributorAuthor

    A fuller set of shortcuts. Each one opens the scanner in a mode, so the next scan(s) do one job:

    Shortcut What the scans do
    Details Scan any Kept code: it opens that place, container or thing. This is today's /scan.
    Move Two scans in either order: a thing or container, and a place or container. Whichever comes first, the second completes the pair and the item is moved there, with a short confirmation and Undo. Scanning a further item after a place moves it to the same place (a row of boxes onto one shelf). Two things in a row, or two places in a row, replaces the first scan with a clear message. A thing scanned as the target container is allowed only when it is a container.
    Take out / Put back The checkout flow of #378: take something out or put it back without changing its home place. A thing that is out shows where it belongs and offers Put back.
    Scan session Today's /scan-session (continuous counting).

    Android shows up to four shortcuts in the long-press menu, so these four fit. The order above puts the most frequent first. A mode should stay visible on the scanner screen (e.g. a "Move" chip), so a scan never does something the person did not expect. The move-by-scan pairing would also serve the move sheet in #575.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions