Troubleshooting

Troubleshooting Login & Passkeys Both

Step-by-step diagnostic procedures for resolving authentication and sign-in issues.

"Passkey not recognized" / Cancelled Prompt: Ensure your browser has permission to access biometric hardware (Windows Hello, Touch ID, or Android Biometrics). If using a hardware security key (YubiKey), verify it is plugged in before initiating login.
Origin / Domain Mismatch: Passkeys are cryptographically bound to specific domain origins. If you registered a passkey on app.taptidy.com, it cannot authenticate requests on localhost or a self-hosted custom domain. Re-register the passkey for your active domain in Developer settings.

Missing Emails: Check your spam/junk folder for messages from auth@my.taptidy.app.
"Token Expired": Magic link tokens and 6-digit OTP codes expire after 15 minutes. Request a fresh code from the sign-in screen.
Link Opens in Wrong Browser: If clicking a magic link on mobile opens an in-app browser instead of your primary session, copy the link URL and paste it directly into your default browser where TapTidy is active.

15-Minute Cooldown: Entering an incorrect PIN 5 consecutive times triggers an automatic 15-minute brute-force lockout.
Owner PIN Reset: Household owners and co-owners can reset a child's PIN immediately in Household Settings → Member Details → Reset PIN without waiting for the cooldown to expire.