Welcome
🌟 About MarineStock
MarineStock is a maritime inventory management system designed for vessels. It replaces paper stock books and spreadsheets with a reliable, multi-device synchronized database that works online and offline.
1
Who uses it
Engineers track lube oils and chemicals. Deck officers prepare FAL declarations and ROB reports. Chief Mate and Master oversee low stock and expiries. Super Admin manages devices across the fleet.
2
Core concepts
Items are what you track. Locations are where they live on the ship. Transactions record every change. Sections group items (Lube, Chemicals, Paint, etc.). Devices are phones or tablets activated to this vessel.
3
Your vessel is isolated
Each vessel has its own database. Crew on MV Armada 8606 cannot see data from any other vessel, and vice versa.
💡 For the full reference, tap "Download PDF Manual" at the top of this help page. The PDF has 30 pages covering every feature.
Welcome
🚀 What's New in v5.3
Version 5.3 brings significant improvements to daily workflows. Here's what changed from v5.2.
1
Multi-Location Stock
One item can now live in multiple storage locations with independent quantities. A 200 L drum of coolant can show 80 L in ER and 120 L in Workshop, tracked separately, but reported as one item.
2
List & Dense views
Toggle between Card, List, and Dense views depending on whether you need detail or density. List and Dense show many more items per screen.
3
Item Detail Modal
Tap any item anywhere to see complete details with embedded ADD, USE, Edit, Label, History, and Move buttons.
4
FAL Form 3 PDF
Proper IMO-formatted declaration with 3-tab picker: By Section, Individual Items, and Custom Items (for fuel/water not in inventory).
5
Move Stock
Dedicated flow for transferring stock between locations with proper audit trail (remarks required). Appears as ↔ teal in the transaction log.
6
Label Generator + Copies
Print labels for many items at once with Dymo or A4 formats. Print up to 50 copies of the same label.
7
Auto-hide action buttons
Floating buttons (Add, QR, AI) slide out of the way when scrolling so they don't cover item quantities.
Getting Started
📱 Device Activation
Before you can use MarineStock, your device must be activated by the Super Admin (Maynard). Each device needs a one-time access code.
1
Contact Super Admin
Ask Maynard for a 6-digit access code. Super Admin generates it from the admin panel.
2
Open MarineStock on your device
Go to marinestock.app on your phone or tablet. You'll see a locked activation screen.
3
Enter the access code
Type the 6 digits. Codes are one-time use — after activation the code is spent.
4
Set your device name
Pick a clear name like "2/E iPhone" or "ER Tablet" — this is what other crew see in transaction history and chat.
5
Generate your Recovery PIN
A 4-digit PIN is created. Write it down. You'll need it if your device is revoked and needs reactivation.
⚠️ Access codes are one-time only. If activation fails, you need a NEW code — the same code cannot be reused.
Getting Started
🔓 Recovery PIN & Delete PIN
MarineStock uses two PINs. They do different jobs — don't confuse them.
1
Recovery PIN (4 digits)
Set during device activation. Used to restore access if browser cache or data was cleared, or if Super Admin revoked the device. Always enter it on the 🔓 Recover with PIN screen.
2
Delete PIN (4 digits)
Set in Settings. Required before deleting any item. Prevents accidental deletions. Share only with trusted crew who need to delete items.
3
Only cache/cookies were cleared — instant recovery
Tap 🔓 Recover with PIN, enter vessel ID + 4-digit PIN. The system verifies against your device's hidden ID and signs you straight in. No admin needed.
4
ALL site data was cleared — admin approval (v5.4.8+)
If your browser's hidden device ID is gone, the system still verifies your PIN against the cloud record. If it matches, you see "PIN Verified! Waiting for Admin..." Admin gets a one-tap Approve or Decline in chat. Once Admin approves, you're signed in automatically — no code to copy, no extra steps. This extra gate prevents anyone with a leaked PIN (e.g. a crew member on vacation) from logging in remotely without admin approval.
5
Wrong PIN
If the PIN doesn't match any active device, you see "Incorrect Recovery PIN" with red pin dots. Try again, or tap 💬 Message Admin for Code if you've genuinely forgotten it.
6
Forgot the Delete PIN?
Super Admin can reset the Delete PIN from the admin panel.
💡 Best practice: write your 4-digit Recovery PIN on a card kept somewhere safe. Combined with admin approval, you can always get back in within minutes — even after a full data wipe.
Getting Started
📶 Offline Mode
MarineStock v5.4 is usable offline. You can browse, edit quantities, log transactions, create new items, and attach photos or MSDS files with no internet. Everything syncs automatically when connection returns.
1
What works offline
View inventory, edit quantities, log ADD/USE/MOVE/DISCARD transactions, generate PDF reports, create brand new items, duplicate items, attach photos and MSDS files. All the daily essentials.
2
What still needs internet
Chat with admin, AI features (Scan, Auto-Fill, Insights), Firebase admin tools, downloading other vessels' data. These require a live connection to the cloud.
3
Sync indicator in the header
☁️ SYNCED = online, everything up to date. 🔌 OFFLINE = no internet (changes are being queued locally). A small 📤 N badge = that many photo/MSDS uploads are waiting. A red ⚠ N badge = uploads failed after 5 retries and need manual action.
4
Photo and MSDS uploads while offline
When offline, photos are compressed on your device and stored in a local queue. The item shows an amber 📤 PENDING UPLOAD placeholder in place of the photo. Once you come back online the photo uploads automatically in the background, and the placeholder is replaced with the real photo within a few seconds.
5
Managing the upload queue
Settings → 📶 Offline & Sync → Pending Uploads → Manage. The panel shows every queued photo and MSDS file with status, size, and age. You can retry failed uploads individually, retry all failed at once, discard uploads you no longer want, or force an immediate drain.
6
When uploads fail repeatedly
After 5 failed attempts an upload is marked FAILED and stops auto-retrying (to avoid wasting battery on a broken connection). You'll see a red warning badge on the sync pill. Open Pending Uploads, check the error message, fix the cause (usually reconnect or check Firebase Storage is reachable), then tap Retry. If the file is no longer wanted, tap Discard.
7
Item-level pending indicators
Any item with a pending photo or MSDS upload shows a 📤 PENDING UPLOAD chip next to its name in card view, or a small 📤 icon in list/dense view. Tap the chip to jump straight to the Pending Uploads panel.
8
Device-local queue
The upload queue is stored on this specific device in your browser's IndexedDB (database name: marinestock_ouq_v1). It persists across reloads and browser restarts. If you clear the browser site data for marinestock.app, the queue is lost — queued files are unrecoverable. Wait for the sync pill to clear before clearing site data.
💡 Tip: the queue survives across page reloads and even browser restarts. If you create items and attach photos while at sea with no connection, leave the tab open (or let the PWA install) — the instant you get WiFi in port, everything uploads in the background.
Viewing
🏠 Dashboard Overview
The home page shows a summary of your vessel's inventory at a glance.
1
Summary cards at top
Total Items, Low Stock count, Small Oils (total liters across lube oils), Month Transactions. Quick pulse check of vessel state.
2
Section tiles
Lube, Chemicals, Paint, etc. — each shows its item count. Tap a tile to filter the item list to that section only. Tap "All" to show everything.
3
Expiry Alerts
Shows items expiring within your configured window (default 3 months). Red = expired, orange = expiring soon.
4
Low Stock Alerts
Items where total qty is below their minimum threshold. Use this as your reorder to-do list before port.
5
Recent Transactions
Last several transactions across all items. See who changed what, when, with what remarks.
Viewing
📄 Card / List / Dense Views
Three display modes for the inventory. Switch based on what you need right now.
1
Card view (default)
Large cards with photos, full details, visible action buttons. Best for detailed browsing and acting on items directly.
2
List view
Compact rows. More items per screen. Best for scanning many items. Each row has a ⋮ button on the right for More actions.
3
Dense view
Most compact. Minimum info per row. Best for finding a specific item by name when you know what you're looking for.
4
How to switch
Tap the view toggle icon in the inventory toolbar. Your preference is saved per device.
5
Column picker (List/Dense only)
Choose which columns show: Location, Part Number, Supplier, Section, Category. Keep only what you use — fewer columns = more room for item names on small screens.
💡 Chief Mate's tip: use List view with Location column ON when doing a physical inventory audit by storeroom. Tap each row to open details, verify, move on.
Viewing
🔍 Item Detail Modal
The central hub for any item. Tap any item (card, list row, or dense row) to open it.
1
What it shows
Photo, name, section, part number, category. Quantity breakdown (per-location if multi-loc). Min stock, expiry, supplier, category, remarks, MSDS link. Created and updated timestamps.
2
Action buttons at bottom
ADD logs an add transaction. USE logs a deduct. Edit opens the full edit form. Label prints a single label. History shows this item's transaction log. Move (multi-loc only) transfers stock between locations.
3
Multi-location breakdown
Items with multiple locations show each one listed separately with its own qty. You can see at a glance how stock is distributed.
4
Expiry badge
Red "EXPIRED" or orange "EXPIRING" badge appears next to the expiry date if relevant. Dismissable by resolving the issue (discard expired stock, restock fresh).
Viewing
🔎 Search & Filter
The inventory can hold 300+ items. Use search and filters instead of scrolling.
1
Search bar (top of inventory)
Searches item name, supplier, part number, and location. Case-insensitive. Filters as you type.
2
Section filters
Tap a section tile (Lube, Chemicals, etc.) to show only that section. Tap "All" or the same tile again to reset.
3
By Location view
Sidebar → Records → By Location. Groups all items by their primary location. Useful for physical audits by storeroom.
4
Custom sections
Beyond built-in sections, you can add custom ones (Power, Refrigerant, Consumables) in the sidebar. They appear in the section picker and filters.
Managing Items
➕ Add New Item
Requires internet connection. Offline devices cannot create new items — they can only edit existing ones.
1
Tap the blue + button
Bottom right floating button on the inventory page. (It auto-hides while scrolling — just stop or scroll up to bring it back.)
2
Fill in required fields
Name, Section, and Unit are required. Everything else is optional but helpful: Part Number, Supplier, Category, Min Stock, Expiry, Remarks.
3
Add Stock Locations
At least one location with a quantity. Tap "+ Add Location" to add more if the item is split across storerooms.
4
Optional: photo and MSDS
Attach a photo of the product label (for visual recognition) and/or the MSDS PDF (for safety data). Helpful for chemicals.
5
Save
The item is created and a "create" transaction is automatically logged. Now it appears in inventory.
💡 AI Auto-Fill: if enabled, take a photo of a product label and the AI tries to extract name, part number, supplier. Speeds up data entry. Review before saving — results can be approximate.
Managing Items
📦 Multi-Location Stock NEW IN V5.3
One item, multiple storage locations, independent quantities. This is the single biggest change in v5.3.
1
Why it matters
Before: a 200 L drum of coolant split between ER and Workshop had to be either inaccurate (pick one location) or confusing (create two items with the same name). Now: one item, two locations, each with its own qty.
2
Add a location when creating
In the Add Item form, the Stock Locations section starts with one row. Tap + Add Location for more rows. Each has Location, Sublocation (optional), Quantity.
3
Add a location to existing item
Open the item, tap Edit, scroll to Stock Locations, tap + Add Location, fill in, save.
4
How multi-loc items display
Card view shows a "📦 N locations" badge. Item Detail lists each location separately. Transactions prompt you to pick which location when logging ADD or USE.
5
Low stock on multi-loc
Min Stock compares against the TOTAL across all locations, not per-location. An individual location can be empty without triggering a warning, as long as the total stays above min.
Managing Items
⚖️ ADD / USE Transactions
A transaction is any change to stock. Every change is logged permanently.
1
Quick transactions from Card view
Each card has + and − buttons. Tap to open a simple transaction modal: quantity, remarks, crew name/rank, date.
2
From Item Detail
Open an item, tap ADD (green) or USE (red). Same transaction form. Works regardless of view mode.
3
Multi-location: which location?
If the item has multiple locations, a dropdown appears asking which one the stock is being added TO (for ADD) or taken FROM (for USE).
4
Remarks are recommended
Not required, but explaining "why" helps future audits. Examples: "Delivered Singapore port call 2026-04-13", "Monthly ER maintenance", "Engine cooling top-up".
5
History is permanent
Transactions cannot be edited or deleted. Made a mistake? Log a correcting transaction (deduct what was wrongly added, with remarks explaining).
Managing Items
⇄ Move Stock Between Locations NEW IN V5.3
Moving 10 L of coolant from Workshop to ER is a move, not a deduct + add. Proper audit trail matters.
1
Open the item
Tap the item to open its Item Detail modal. The Move button is visible only for multi-location items.
2
Tap Move
The Move Stock modal opens. Pick From location (source) and To location (destination). Enter quantity.
3
Remarks required
You must explain why. "Consolidating for next survey", "Moved to correct location after mislabel", etc.
4
Review preview
Before saving, the preview shows both locations' quantities before and after the move. Confirm it looks right.
5
Log appearance
Move transactions show as ↔ teal in the transaction log, with both from and to locations. Overall item qty doesn't change — just the distribution.
💡 Auto-cleanup: if you move all stock out of a location (making it 0) and the item has other locations, the emptied location is automatically removed to keep the list clean.
Managing Items
🗑 Discard Stock
Sometimes stock is removed without being productively consumed — expired, damaged, spilled, emptied for maintenance. Discard is different from USE.
1
When to use Discard
Expired oil dumped, damaged chemical discarded, emptied cylinder for recharge, spilled stock written off.
2
How to discard
Edit the item, change the location's qty to a lower amount (or zero). The app detects this as a discard candidate and asks you to confirm with remarks.
3
Log appearance
Discards show as 🗑 grey in the transaction log, separate from USE (red −) transactions. This keeps your USE transactions reflecting actual productive consumption for reporting accuracy.
Managing Items
✏️ Edit & Delete
Change any item's fields. Delete requires PIN.
1
Reach Edit
Card view: tap the pencil icon. Item Detail: tap Edit button. More menu (⋯ or ⋮): tap Edit.
2
Change fields
Update name, section, part number, supplier, category, unit, min stock, expiry, remarks, stock locations, photo, MSDS.
3
Qty changes become transactions
Changing a location's qty logs an add or deduct. Changing a location name (rename) while stock > 0 logs a move. If you change both, v5.3 detects this and logs a move and qty-change accurately.
4
Confirmation before save
If qty changes are detected, a confirmation modal shows what will be logged. Review before confirming — prevents accidental edits from creating misleading transaction records.
5
Delete
From More Menu → Delete Item. Requires the 4-digit Delete PIN (set in Settings). Deletion is permanent — all transaction history also deleted. Be certain.
⚠️ Deletion cannot be undone. If unsure, log a "hidden" discard transaction bringing qty to 0 rather than deleting.
Managing Items
⧉ Duplicate Item
Creating similar items (e.g. "Primer Grey 5L" and "Primer White 5L") is common. Duplicate copies structure; quantities start at zero.
1
Open More Menu
Card view: tap ⋯. List/Dense view: tap ⋮ or long-press the row.
2
Tap Duplicate Item
A new Add Item form opens, pre-filled with the source item's values. Name shows "Copy of [original]".
3
Adjust and save
Change the name, update other fields as needed. Quantities in all locations start at 0 (deliberate — duplicating structure, not stock). Save to create the new item.
Reports
📊 Reports Overview
MarineStock generates multiple report formats for different audiences.
1
Simple PDF
Straightforward inventory list. For general reference, printed copy in the office, fleet manager email.
2
Monthly PDF
Detailed report with opening balance, receipts, consumption, closing balance per section. For monthly engine logs and company reports.
3
ROB Report (PDF/Excel)
Remaining On Board — current quantities for port calls. Multi-location items show parent row plus indented sub-rows per location. Low-stock highlighted.
4
FAL Form 3 (IMO declaration)
Ship's Stores Declaration for port authorities. See the dedicated FAL Form 3 help page for the 3-tab picker.
5
Excel exports
Eco-Online format for chemical management systems, or full inventory template.
6
How to open Reports
Sidebar menu → Exports, or Settings → Generate Report. Pick a format from the dropdown.
Reports
📋 FAL Form 3 Declaration UPGRADED IN V5.3
IMO FAL Form 3 is required for every port call. MarineStock generates a properly formatted PDF with a 3-tab item picker.
1
Open the FAL3 flow
Sidebar → Exports → pick "PDF — FAL Form 3 Declaration". The 3-tab picker opens.
2
Tab 1 — By Section
Pick whole sections. Check "Lube Oil" and all items in that section are included.
3
Tab 2 — Individual Items
Pick specific items regardless of section. Searchable, filterable. Useful when you want (say) all dangerous chemicals across sections — not the entire Chemicals section.
4
Tab 3 — Custom Items
For items NOT in MarineStock inventory — fuel oils (HFO/MGO), fresh water, gas cylinders, sludge, provisions. Type name, qty, unit, location. Appears in PDF under "Additional Stores".
5
Save your default
If you always declare similar items, save the selection as your device's default. Next time, tap "📂 Load my default" to restore. One saved default per device per vessel.
6
Fill the form screen
After picking items, fill declaration fields: Arrival/Departure, IMO number, Call Sign, Port, Date, Flag State, Officer (defaults to device), Rank (defaults to "Master" — FAL3 is signed by the Master).
7
Generate PDF
Properly formatted IMO table with vessel info, item grouping, page numbers, signature block on last page.
💡 Long-lived fields (IMO, Call Sign, Flag, Officer) are saved on your device for next time. Per-voyage fields (Port, Date, Voyage No.) are blank each time — they always change.
Reports
📈 ROB Report
Remaining On Board — current quantities of all items. Used at port arrivals and bunker calls.
1
Access
Sidebar → Records → ROB Report, or Exports → Reports.
2
Export formats
PDF (for port authorities) or Excel (if recipient prefers spreadsheet). Both contain the same data.
3
Multi-location items
Show as a parent row with "📦 N LOCATIONS" badge, plus indented sub-rows per location with individual quantities. Total is at parent level.
4
Low-stock highlighting
Items below their min stock threshold are highlighted with a warning color for easy spotting by the port officer or surveyor.
Reports
📜 Transaction Log
Every change to stock is recorded permanently. The log is your audit trail.
1
Access
Sidebar → Records → Transactions, or the Transactions tab in admin view.
2
View modes
Toggle By Date (chronological) or By Item (grouped per item). By Item is useful for "show me everything that happened to Castrol PG 220".
3
Transaction type icons
Green + = add, Red − = deduct (USE), Teal ↔ = move, Grey 🗑 = discard. Colour-coded for quick scanning.
4
What gets logged
Item, type, qty delta, before/after, location (if multi-loc), remarks, crew name/rank, device, timestamp.
5
Export
Filter by date range, item, or section first, then export as PDF or Excel. Useful for audits and month-end reports.
Reports
📸 Snapshots
A snapshot is a point-in-time capture of the entire inventory. Useful for month-end reconciliation or pre-port archives.
1
Save a snapshot
Settings → Snapshot, or the snapshot button in the Records area. Pick sections, give a label (e.g. "Month-end April 2026"), save.
2
View History
Sidebar → Records → History. List of all snapshots with date, label, and diff against the previous snapshot (what changed).
3
Non-blocking
Saving a snapshot doesn't freeze the app — keep working while it's saved. Snapshots are read-only after creation.
Labels
🏷 Print Single Label
Print one label for a specific item. Use when re-labeling after a spill, worn label, or new delivery.
1
Open the More Menu
Card view: tap ⋯. List/Dense view: tap ⋮ (far right of row). Tap Print Label.
2
Choose label size
36×89 mm (Dymo 30336) or 28×89 mm (smaller Dymo tape).
3
Choose what to include
Item name (always), Location, Sublocation, Quantity, Unit, Min Stock, Part Number, Supplier, Section, Expiry, Remarks, QR Code. Check what you need. Less content = clearer print on small labels.
4
Set Copies (v5.3 new)
Default is 1. Type up to 50 if you need multiple identical labels (one for drum, one for shelf, one for storeroom door).
5
Preview & print
Review the live preview. Tap "Print Label". The browser print dialog opens — select your Dymo printer (or save as PDF).
Labels
📷 Bulk Label Generator NEW IN V5.3
Print labels for many items in one job. Perfect for re-labeling a storeroom or after a big delivery.
1
Open Label Generator
Sidebar menu (☰) → Tools → Label Generator.
2
Pick items — two tabs
By Section: pick whole sections, all items print. Individual Items: search/filter and pick specific items. Running total shown at bottom.
3
Layout & content
Tap Next → Layout. Choose format: Dymo 36mm, Dymo 28mm, or A4 Sheet (21 labels per page, Avery L7160). Check which fields to include on every label.
4
Copies per item
Default 1. Set up to 50 to get that many copies of each picked item. 23 items × 2 copies = 46 labels.
5
Print
Browser print dialog opens. For Dymo: one label per page. For A4 Sheet: 21 per page.
💡 Which format to use: Dymo if you have a label printer with tape. A4 Sheet if you have a regular office printer with Avery label sheets.
Labels
📱 QR Code Scanning
Labels with QR codes deep-link to the item in MarineStock. Scan to jump directly to that item.
1
Open QR scanner
On the inventory page, tap the orange camera (QR) floating button. Camera view opens.
2
Point at the QR code
The camera automatically detects and reads QR codes. Good lighting helps.
3
What happens
If the QR is a MarineStock label for an item on THIS vessel, the app opens that item's detail page directly. If the QR is for a different vessel or an unknown format, an error message appears.
4
QR content
QR codes encode "MS:{vesselId}:{itemId}". This means QRs are vessel-specific — a label from one vessel won't work on another.
Bulk Actions
📝 Update Multiple Items
Change quantities on many items at once. Fastest way to reconcile inventory after a port delivery or monthly count.
1
Access
Sidebar → Bulk Actions → Update Multiple Items.
2
Pick items
By section or individually. Multi-location items show one row per location so you can update each one independently.
3
Enter new quantities
Type new values where they differ from current. Items with no change are skipped — no redundant transactions.
4
Add remarks
Required — what was the delivery or adjustment reason? This note applies to all transactions in the batch.
5
Save
A transaction is logged for each changed item. Review the transaction log afterward to confirm.
Bulk Actions
🗄 Bulk Move / Delete
Move many items to a new location at once, or bulk-delete. Use with care.
1
Bulk Move
Pick items, enter new Location (and optional Sublocation), save. Each item's primary location is updated. A move transaction is logged per item. Multi-location items are skipped with a warning — use per-item Move Stock for precise control.
2
Bulk Delete
Pick items, confirm with Delete PIN. Items are permanently removed. Dangerous — only Super Admin should typically do this.
⚠️ Bulk Delete cannot be undone. Export a backup (or snapshot) first if you're unsure.
Bulk Actions
📊 Excel Import
Upload a filled-out Excel template to update many items at once — useful for spreadsheet-based monthly counts.
1
Download template
Settings → Data → Download Template. Gives you a .xlsx file pre-filled with all current items.
2
Edit in Excel
Update quantities, locations, remarks. Save.
3
Upload
Sidebar → Bulk Actions → Excel Import, or Settings → Import. A preview shows what will change.
4
Choose update mode
Qty only, Qty + Location, or All fields. Confirm — transactions are logged for each change.
💡 Multi-location items are skipped for Excel import safety (Excel can only represent single-location). Use Excel for single-location items; use the app for multi-location.
Other
💬 Chat & Support
Built-in chat between crew devices and Super Admin. Use for inventory-related questions.
1
Access
Sidebar → Chat, or the Messages tab on the home page.
2
Who you can reach
Super Admin (for support, asking about features, reporting issues) and other crew devices on the same vessel.
3
What to use it for
Inventory context: "Are we out of Enviroclean?", "What's the product code for the 5L paint in Workshop?", "Adding new medicine — which section?". Not for general ship comms — use WhatsApp or radio for that.
4
Attachments
Attach a photo (online only — offline can't upload images). Reply threads supported.
Other
🎨 Paint Specs
Dedicated feature for the Paint section — upload paint system spec PDFs.
1
Why
Paint manufacturers provide system spec PDFs (product codes, mixing ratios, application notes). Having them inline with your paint items helps surveyors and crew doing maintenance.
2
Upload
Paint section → Specs tab → Upload PDF. Give it a name.
3
Delete requires PIN
Deleting a spec requires the 4-digit PIN. This prevents accidental removal of important documents.
Other
⚙️ Settings
Per-device and vessel-wide preferences. Sidebar → Settings.
1
Vessel Information (shared)
Vessel Name — appears on all reports and in the header. Set once during onboarding; rarely changes.
2
This Device (per-device)
Device Name — what crew see. Prepared By — name on PDF exports. Each device has its own settings.
3
Display
Theme (Dark/Light/Auto Night), text size, expiry warning window (months before flagging).
4
Data section
Download Template (filled Excel of all items) or Download Blank template. Used for bulk imports.
5
Snapshots
Save a point-in-time capture of the inventory. Useful for month-end reconciliation.
6
AI Settings (if enabled)
AI Item Photo ID, AI Item Assistant, AI Inventory Insights. Per-vessel enablement by Super Admin.
Other
🛠️ Troubleshooting
Common problems and their fixes.
1
"Invalid access code"
Code may be used already (one-time). Check for typos — case-sensitive. Codes older than 30 days are invalid. Get a new one from Super Admin.
2
App shows "OFFLINE" but I'm online
Firebase takes 5-10 seconds to connect on first load. Pull down to refresh, or close and reopen the tab.
3
Transactions not syncing
Offline transactions sync when back online — give it a few minutes. If stuck, check the yellow sync indicator for error messages.
4
Two devices show different item counts
Usually a sync delay — wait 30 seconds and refresh both. If persistent, one device may have stale cache — hard refresh (close and reopen).
5
Label prints tiny or blank
Browser's print paper size doesn't match label size. In print dialog, set paper size to "Custom" matching your label dimensions. Disable "Fit to page" if on.
6
QR code won't scan
Label damaged or low-contrast. Print at higher DPI. Ensure good lighting when scanning.
7
Low stock alert for item I know is fine
Min Stock may be 0 or unset — alerts disabled unless min > 0. Or item has qty in another location you haven't checked. Open Item Detail to see all locations.
💡 For issues not covered here, see the full troubleshooting section in the PDF manual, or message Super Admin via chat.