Troubleshooting

The app is installed but my workflows don't run

Three things to check, in order:

1. The Accessibility service is enabled. Open Android Settings → Accessibility → Installed apps → smartordercapture. The toggle must be on. If you upgraded the app recently, Android may have silently disabled the service.
2. The foreground service is running. You should see a persistent notification "smartordercapture is armed". If not, open the app and arm at least one workflow.
3. The device is paired. The dashboard's Devices page should list this phone with a recent last-seen timestamp. If not, re-pair via /devices/pair.

A `tapByText` action fails to find its target

tapByText walks the accessibility tree looking for a node whose text matches. It can miss for three reasons:

• The text is in a custom-drawn view (canvas) and isn't exposed via the accessibility API.
• The text matches but the element isn't clickable. We climb to the nearest clickable ancestor; if there isn't one, the tap is a no-op.
• The matchMode is exact but the on-screen text differs by a character (a stray period, a different language string).

Trigger fires but the workflow does nothing

Open the run from the dashboard. The trace tells you which node ran and which one failed. The most common cause: the trigger fired while the target app wasn't in the foreground, so tapByText with no inPackage filter couldn't find the element. Add an action.openApp early in the workflow to put the right app in view before the taps run.

Workflow refuses to save (validation failed)

The builder validates with the same Zod schema the API uses. Open the inspector for the node with the red ring — it shows the specific validation message. Common cases:

• packageName doesn't match the Android package regex.
• cron doesn't have 5 fields.
• A branch edge is missing its true/false label.
• The workflow has no trigger.

Workflow refuses to save (denylist violation)

You've targeted a package on the denylist. The error message names the offending package. Remove the node referencing it; the workflow will save once nothing in it touches a denylisted package.

Runs upload slowly or not at all

Runs are written to the device's local Room database first, then uploaded to the cloud. On a slow network, expect a few-second delay before they appear in the dashboard. If they never appear:

• Check that the device is still paired (see above).
• Open the run history tab in the Android app — runs that haven't uploaded yet have a small offline icon.
• Force-quit and reopen the app to trigger an upload retry.

Email verification never arrived

Check spam first. If still missing, request a new one from the verify-email page. Rate limit is 5 sends per 10 minutes per address. If still missing after that, email support@smartordercapture.com with the signup email and we'll dig into our delivery logs.

Password reset link doesn't work

Reset links expire after 1 hour. If the link looks valid but the page says "invalid token", request a new one — Better-Auth invalidates the old link as soon as a new one is requested.

Stripe checkout returns me to /billing without upgrading

You probably clicked Cancel in the Checkout page, or your payment method was declined. Free trials don't convert without a card. If a charge appeared but the plan still says Free, wait 30 seconds (the Stripe webhook usually arrives within a couple of seconds; we cap our retry window at 30s of polling on the success page). If it persists, email billing@.

The Play Store version got pulled — what now?

Use the direct APK from /download. Your account, workflows, run history, and billing are unchanged. You'll need to re-pair the direct install and re-enable the Accessibility service since Android treats it as a different app.

Still stuck?

Email support@smartordercapture.com with: the workflow id, the failing run id, what you expected, what happened. We respond within 24 hours on Pro and 4 hours on Team.