What Is a Debug Report?

A debug report is a small text file that contains technical information about how the app has been running on your device. It helps us diagnose problems and improve Field Service Companion.

What Is Included

The debug report contains:

• App information — the version and build number of Field Service Companion installed on your device.
• Device information — your phone model, operating system version, screen size, and language setting.
• A log of recent app events — such as which screens were opened, whether a backup was attempted, or whether the map had trouble looking up an address.
• Error details — if something went wrong, the report includes a technical description of the error.

What Is NOT Included

The debug report never contains any of your personal information. Specifically, it does not include:

• Contact names, phone numbers, or addresses.
• Visit notes or anything you have written.
• Photos or attachments.
• Your name, email address, or account details.
• Your location.

The diagnostic log is stored separately from your encrypted data and contains no personal content of any kind.

How It Works

Field Service Companion keeps a small rolling log — about a thousand app events at any given time — on your device. This log runs continuously in the background, similar to how a car's dashboard records basic operating data. Older events are quietly dropped as new ones come in, so the log never grows unbounded.

Every entry passes through a privacy filter before it reaches the log: the filter strips email addresses, phone numbers, addresses, and similar patterns, so even if a low-level error message accidentally referenced a piece of contact data, the log would already have it scrubbed. The same filter runs again when a report is shared, so two layers of protection sit between any personal content and a report leaving your device.

There are two ways a report can be shared:

• You initiate it. Settings → Share debug report opens your phone's share sheet so you choose where to send it.
• After a crash, automatically. If the app closes unexpectedly, the next launch sends a report directly to our PostHog telemetry pipeline so we can see and fix the issue as quickly as possible. This default is on; you can turn it off any time in Settings → "Send diagnostic data".

What to Expect After Sending

After you send a debug report to us at support@returnvisits.org, our team will review the technical details to understand the problem. We may contact you for additional information if needed. The report helps us reproduce the issue and include a fix in a future update.

Debug reports are used solely for troubleshooting. They are never shared with third parties, used for marketing, or connected to your identity.

Need More Help?

If you have questions about debug reports or privacy, please contact us at support@returnvisits.org. A friend who is familiar with Field Service Companion may also be able to help you.