Mobile App

Logging In on Mobile

There are two ways to log in on the mobile app: email/password or login barcode (printed badge).

Email and Password

1. Launch the ListerLeo app.
2. Enter your email address and password.
3. Tap Sign In. Auth posts to POST /api/auth/login and a Sanctum token is stored in secure storage.

Login Barcode (Faster)

If typing on a phone is inconvenient (especially with gloves in a warehouse), use the login barcode method. See Login Barcode below.

Login Barcode

The login barcode lets workers sign in by scanning a printed badge instead of typing an email and password. Each user has a permanent login_barcode value stored on their account — admins print it as a badge from the Users resource.

Generating a Login Badge

1. An admin opens the Users resource in the Filament admin panel.
2. For each user with a login barcode, the row exposes a Print Login Badge action (printer icon).
3. Clicking it opens the hidden-iframe print flow that renders the badge via the desktop label-print route. API clients can render the same badge by posting to POST /api/labels/login.
4. Changing a user's password auto-rotates their login barcode for security.

Logging In With a Badge

1. On the mobile app's login screen, tap Scan Barcode to Login.
2. Either scan the badge with a hardware scanner into the Scan Login Barcode input, or tap Open Camera Scanner to use the phone's camera.
3. The scanned value is posted to POST /api/auth/barcode-login and a Sanctum token is returned.

Scanning Items on Mobile

The mobile scanning flow mirrors the desktop Processing Station: pick a context, scan into a focused input, then review and save. A hardware (USB/Bluetooth keyboard-emulating) scanner is the fastest input — the camera scanner is the fallback when no hardware scanner is connected.

How to Scan

1. Tap the Scan tab at the bottom of the home screen.
2. On the Context Selection screen, pick an Auction (the vendor is derived from it) and a Lot mode: Manual Lot Control, Lot Per Item, or an existing lot. If the auction has lot_per_item set, the picker is locked.
3. On the scanning screen, either fire your hardware scanner into the focused input or tap Scan to open the camera scanner (BarcodeScannerScreen). Tap the keyboard button to cycle between hidden, numeric, and full keyboard modes for manual typing.
4. If the barcode resolves via GlobalSKU, the review screen appears pre-filled. If it doesn't, tap No UPC - Take a Photo to send a photo for AI lookup instead.
5. On the review screen, take photos with the camera, set the condition, edit fields as needed, and tap Confirm & Save (posts to POST /api/scan).
6. If force_putaway is in the resolved workflow steps, the Force Put-Away screen takes over next — see below.

Force Put-Away on Mobile

When the resolved workflow includes force_putaway, the app pushes the Force Put-Away screen after each save. It has two stages:

1. Scan the printed label. The scanned value must match the saved item's serial number or original barcode.
2. Scan the destination. Pallets, shelves, rows, or a brand-new label string are all accepted — new labels auto-create a Location.

The bottom of the screen has dedicated Scan (camera) and Numpad / Full Keyboard / Hide Keyboard buttons that act on whichever input is currently visible. Tap Skip in the app bar to bail out — the item stays saved, only the put-away placement is dropped.

Reviewing Items on Mobile

Catalogers can review and edit items that have already been scanned, filling in titles, descriptions, and pricing while away from a desktop.

Review Workflow

1. Tap the Items tab on the home screen.
2. Filter by status (Scanned / Cataloged / Put Away / Sold) or use the filter sheet for auction, vendor, warehouse, location, or auction platform.
3. Tap an item to open its detail view.
4. Edit fields, add or replace photos using the phone's camera, and save.

The item detail screen is a streamlined, touch-optimized version of the desktop Filament edit form.

Put-Away on Mobile

Mobile put-away is the most efficient way to assign items to warehouse locations because you carry the device with you as you walk through the warehouse.

Modes

The Put-Away tab has a mode selector at the top:

• Item to Location — Scan an item, then scan a location. Calls POST /api/put-away/item-to-location.
• Item to Pallet — Scan an item, then scan a pallet barcode. Calls POST /api/put-away/item-to-pallet.
• Pallet to Location — Scan a pallet, then scan a location to place the whole pallet. Calls POST /api/put-away/pallet-to-location.

Put-Away Workflow

1. Tap the Put Away tab on the home screen.
2. Pick a mode using the selector at the top.
3. Scan the source (item or pallet) using your hardware scanner, the camera, or the keyboard.
4. The source is shown with its title for confirmation. Carry the item or pallet to its destination.
5. Scan the destination. A success message confirms the placement and the screen resets for the next put-away.

Picking on Mobile

The mobile picking flow walks you through a pick list one item at a time, showing the destination location and the item to retrieve.

Picking Workflow

1. Tap the Picking tab on the home screen.
2. You'll see a list of pick lists (GET /api/pick-lists). Tap one to start picking it.
3. The active pick screen shows the current item with its location prominently displayed.
4. Walk to the location, then scan the item's serial number or barcode to confirm the pick (POST /api/pick-lists/{id}/pick).
5. A success indicator confirms the pick and the next item appears automatically.
6. When all items are picked, a completion banner shows the count.

Items List on Mobile

Browse and search your entire inventory from your phone. The mobile items list is a streamlined version of the desktop items view.

Searching for Items

• Text search — Type a title, barcode, serial number, or brand in the search bar (debounced 400 ms).
• Status chips — Quick-filter by All, Scanned, Cataloged, Put Away, or Sold.
• Filter sheet — Tap the filter icon for additional filters: auction, vendor, warehouse, location, and auction platform.

Tap any item in the list to view its full details, including photos, location, lot assignment, and history.

Printer Setup on Mobile

Connect a Bluetooth or network thermal printer to your phone to print item, pallet, location, and login labels directly from the mobile app.

Connecting a Bluetooth Printer

1. Open the More tab and tap Printer. The Printer Settings screen opens.
2. Under Discover Bluetooth, tap to start scanning. Available printers appear in the list as they're discovered.
3. Tap a discovered printer to save and connect.
4. Optionally add a Network Printer by IP address in the section below.
5. Use the Test Print button at the bottom to verify the connection.
6. In the Label Settings section, set the printer language (ZPL or ESC/POS), label width/height, and print density.

Supported Printer Languages

• ZPL — Zebra Programming Language. Works with Zebra and most Zebra-compatible thermal printers.
• ESC/POS — Receipt and label printers that accept ESC/POS commands.

Connection types include Bluetooth (BLE), Bluetooth Classic, network (TCP/IP), and the device's print subsystem.

Mobile Analytics

Team leads can view a subset of the analytics dashboard on their phone for quick status checks. Open it from the More tab.

Available Reports

The analytics screen pulls from the same endpoints as the desktop dashboard:

• Dashboard summary — GET /api/analytics/dashboard.
• Receiving, Put-Away, Picking, Throughput, User Productivity — individual report screens.
• Vendor Performance, Inventory Aging, Revenue — also available via the analytics report screen.

For the full analytics experience with charts and detailed reports, use the desktop version. The mobile analytics view is designed for quick checks, not deep analysis.