Troubleshooting
common problems and fixes.
Real cases from the code and the build, with what to check.
01"Read this page" finds no price
The app reads the page's schema.org JSON-LD, then Open Graph and product meta tags. Many shops show the price only after a script runs, or do not publish it in those tags. Then the app asks for the price instead of guessing: type it, or use a screenshot. The reader was tested on stored sample pages only, so check it against the shops your users care about.
04Screenshot or shelf tag reading finds the wrong number
Reading runs on the device with Google ML Kit. Poor light, glare and small print reduce accuracy. The user taps the right price on the screenshot, and the confirm card lets them fix any value. If your policy does not allow ML Kit, remove ReadImageScreen and the two packages (google_mlkit_text_recognition, mobile_scanner): nothing else depends on them.
05The paywall says purchases are not set up
No product id is set for this platform. Fill the ids in brand.dart or the console (Where to put the ids). Ids must match App Store Connect and Play Console exactly.
06Products are set but the store returns nothing
iOS: the Paid Apps agreement and tax forms must be complete and the product ready to submit. Android: the app must be installed from a Play test track (not a sideloaded APK) by a licence tester, and the product and base plan must be active. Wait some hours after creating products.
07Purchase verification answers 501
501 verification_off means verification is not switched on in the console, so the app trusts the on-device result. Turn it on under Purchases and fill in the credentials.
08Google Play verification fails with a permission error
The service account must be invited in Play Console with View app information and View financial data, and the Android Publisher API must be enabled in the Google Cloud project. New permissions can take some time to apply.
09App Store lookup fails
Check the bundle id, Key ID, Issuer ID, and that the .p8 text was pasted whole including its BEGIN and END lines. The server tries Production, then Sandbox.
10Currency rates stay empty
The daily ECB fetch is off by default. Switch it on under App config: currency rates. Console, Currency rates shows the last fetch and the last error; the server keeps the last good rates if a fetch fails.
11I cannot find the console setup code
It is printed in the server log at start when ADMIN_SETUP_TOKEN is empty. In Docker run docker logs. Or set ADMIN_SETUP_TOKEN in .env and restart.
12npm ci fails or better-sqlite3 will not load
Use Node 22.12 or newer (node -v). better-sqlite3 is a native module: if no prebuilt file exists for your system, you need build tools (Python 3, make, a C++ compiler). Delete node_modules and run npm ci again after changing Node versions.
13429 errors, or everyone shares one address
/v1 routes allow 60 requests a minute per address. Behind a proxy set TRUST_PROXY_HOPS=1, otherwise all users look like the proxy's address.
14A console change does not appear in the app
The config is cached for 5 minutes and by ETag. Wait, then reopen the app. Check the app was built with API_BASE_URL and that the address is https and reachable from the phone.
15Play rejects the upload or says the app is debug-signed
As shipped, release builds use the debug key. Add your own signing config (Release).
16Xcode says signing failed or the bundle id is not available
The project ships with no team set. Choose your own team and a bundle id you own (Rename).
17iOS build fails on a pod deployment target
The Podfile platform is 16.0 because current Xcode rejects older pod targets. Keep it at 16.0 or higher, then run pod install again.