Common Issues

Solutions to frequently encountered problems in QuickInspect and YachtInspect.

App Not Loading

If the app is not loading or appears stuck on a loading screen:

1. Check your internet connection -- ensure WiFi or mobile data is active and working
2. Force close and reopen -- swipe the app away from your device's app switcher, then reopen it
3. Clear the app cache -- go to your device settings and clear the cache for QuickInspect or YachtInspect (this does not delete your data)
4. Restart your device -- a full restart can resolve temporary system issues
5. Update the app -- ensure you are running the latest version from the App Store or Google Play

Findings Not Syncing

If findings created on one device are not appearing on another, or show a sync warning:

1. Check your internet connection -- syncing requires an active connection
2. Check offline mode -- the app uses local SQLite storage for offline support. Findings created offline will sync automatically when connectivity is restored
3. Force a manual sync -- pull down on the findings list to trigger a sync
4. Wait for upload -- large datasets with many photos may take time to upload, especially on slower connections

Report Generation Issues

If PDF generation fails or the output does not look correct:

Images Not Loading in PDF

• Ensure all images have finished syncing before generating the report
• Check that images are not corrupted -- try viewing them in the app first
• Large images take longer to process; wait for the generation to complete

Large Reports Taking Too Long

• Reports with many images or findings may take longer to generate
• Close other apps to free device memory
• Ensure sufficient storage space on your device
• Try generating during a stable internet connection

Layout Issues

• Use the real-time preview in the Report Designer to check layout before exporting
• Verify that elements are positioned correctly using drag-and-drop
• Check that the findings table and image table elements have data to display

Two-Factor Authentication (2FA) Setup Problems

If you are having trouble setting up or using 2FA:

1. Ensure your authenticator app is working -- 2FA uses TOTP (Time-based One-Time Password) with an authenticator app such as Google Authenticator or Authy
2. Check the time on your device -- TOTP codes are time-sensitive. If your device clock is incorrect, codes will not match
3. Use recovery codes -- if you cannot access your authenticator app, use one of the recovery codes provided during 2FA setup
4. Contact support -- if you are locked out and have no recovery codes, email support@quickinspect.me with your account email for assistance

Company-Enforced 2FA

If your company admin has enforced 2FA, you must set it up within the configured grace period. After the grace period expires, you will be required to complete 2FA setup before accessing the app.

To set up 2FA:

1. Go to the Profile tab
2. Tap Two-Factor Authentication
3. Follow the on-screen instructions to link your authenticator app

Biometric Login Issues

If fingerprint or Face ID login is not working:

1. Verify biometrics work on your device -- test fingerprint or Face ID in your device's system settings
2. Re-enable biometric login in the app -- go to the Profile tab, tap Biometric Login, toggle it off, then on again
3. You will need to authenticate with your password when re-enabling biometric login
4. Ensure your device supports biometrics -- not all devices have fingerprint or Face ID hardware

Still Having Issues?

If your problem is not listed here:

1. Check other documentation:

   • FAQ -- answers to common questions
   • Account & Billing -- subscription and payment issues

2. Contact support:

   • Email: support@quickinspect.me
   • Include your account email, device type, app version, and a description of the issue