Technical
Reporting Bugs
Reporting Bugs
If you encounter unexpected behavior, crashes, or issues in GapFix, we want to hear about it. Detailed bug reports help our development team quickly identify and fix problems. This guide explains how to report bugs effectively.
What Counts as a Bug
A bug is unexpected behavior that prevents normal use or creates a poor experience:
Clear bugs:
- App crashes or force closes
- Features do not work as expected
- Progress is not saved correctly
- Buttons or links do not respond to taps
- Text appears garbled or incorrectly formatted
- Sync fails to complete after many attempts
- Audio or video does not play
- Login fails with no clear error message
Not bugs (expected behavior):
- Feature not yet released (roadmap features)
- Needing to be online to access content
- Needing to log in to view your progress
- Payment processing delays (contact support instead)
- Account issues (contact support instead)
Using In-App Bug Reporting
The easiest way to report a bug is through GapFix's built-in feedback system:
To report a bug in the app:
- Open GapFix and navigate to Settings
- Scroll to the bottom and tap "Send Feedback" or "Report an Issue"
- Select "Bug Report" as the feedback type
- Fill in the title (short description of the issue)
- Describe what happened and what you expected to happen
- If relevant, tap "Attach Screenshot" to include a visual
- Tap "Send Report"
- You will receive a confirmation that your report was submitted
What happens after you submit:
- Your report is sent to our engineering team with your device information
- An automated acknowledgment will be sent to your account email
- You may receive follow-up questions within 24-48 hours
- Once fixed, we will notify you in a future app update
What Information to Include
Detailed information helps us reproduce and fix bugs faster:
Essential information:
- Clear title: "Video playback stops randomly" not "App broken"
- Description: What were you doing when the bug occurred?
- Expected behavior: What should have happened?
- Actual behavior: What actually happened?
- Reproduction steps: List numbered steps to reproduce the issue
Helpful additional information:
- Device model (iPhone 12, iPhone 14 Pro, etc.)
- iOS version (found in Settings > General > About)
- GapFix app version (found in Settings > About GapFix)
- When the bug started (after an update, specific action, etc.)
- How often the bug occurs (always, sometimes, rarely)
- Any error messages you see (word-for-word if possible)
- Screenshot or video of the issue
Example of a good bug report:
"Title: Login button unresponsive after email entry
Steps to reproduce:
- Open GapFix
- Enter email address test@example.com
- Tap password field
- Enter password correctly
- Tap blue 'Sign In' button
Expected: Should attempt to log in Actual: Nothing happens, button does not appear to be tapped Device: iPhone 13 iOS: 17.3 GapFix version: 2.1.4 When it started: After updating to version 2.1.4 yesterday"
Taking Screenshots and Videos
Visual documentation makes bug reports much more useful:
Taking a screenshot:
- Press the Side button and Volume Up button simultaneously
- Release both buttons quickly
- Tap "Save to Photos"
- Open the bug report screen in GapFix
- Tap "Attach Screenshot" and select your photo
Recording a video of the bug:
On newer iPhones:
- Open Control Center (swipe down from top-right)
- Press and hold the Record button (red circle)
- Select the microphone option as preferred
- Tap "Start Recording"
- Perform the steps that trigger the bug
- Open Control Center again and tap the red Record icon to stop
- Video is saved to your Photos app
Then attach or describe the video in your bug report.
Email Bug Reports
If the in-app reporting is not working (because GapFix is completely broken), you can email a report directly:
To email a bug report:
- Send an email to help@gapfix.app
- In the subject line, write: "Bug Report: [Brief Description]"
- Include all information from the "What Information to Include" section above
- Attach any screenshots or videos
- Include your GapFix account email address so we can contact you
Example email subject lines:
- "Bug Report: App crashes when opening lessons"
- "Bug Report: Progress not syncing across devices"
- "Bug Report: Video player buttons unresponsive"
Beta Program
Help us catch bugs before general release by joining the beta program:
To join the beta:
- Open the App Store app
- Search for GapFix
- Scroll down to "About This App"
- Look for "Become a Beta Tester" and tap the link
- Tap "Join" to enroll in the beta program
- You will automatically receive beta versions through the App Store
- Use the in-app feedback tool to report any beta-specific issues
Beta program expectations:
- Beta versions may be unstable or have missing features
- Your feedback is critical for improving the app
- Beta versions should not be used as your only copy
- Be prepared for breaking changes between beta versions
- Participate actively in reporting issues you find
Known Issues and Status
Before reporting a bug, check if it is already known by reviewing app release notes:
Check for known issues:
- Open GapFix and go to Settings > About GapFix
- Look for "Version History" or "Release Notes"
- Search previous version notes to see what was recently fixed
- Check if your issue was already addressed in a recent update
Following Up on Your Bug Report
After submitting a report:
- Save the confirmation email or reference number
- Check for responses to your report in your email
- Please allow 24-48 hours for initial response
- Engineers may ask follow-up questions or request additional information
What if the bug is not fixed soon?
- Bugs are prioritized by severity and frequency of occurrence
- Critical bugs (app crashes, data loss) are fixed fastest
- Minor bugs may take several weeks or months
- You can check the status of your report in your account
- Major fixes are included in app updates (check release notes)
Security Bugs and Privacy Issues
If you discover a security vulnerability or privacy issue:
Do not report publicly. Instead:
- Email help@gapfix.app with details
- Do not share the vulnerability in public forums
- Include your contact information for follow-up
- Allow 72 hours for a response from our security team
- Consider not using the vulnerable feature until it is fixed
We appreciate responsible disclosure and may include you in our acknowledgments.
Troubleshooting Before Reporting
Before reporting, try these steps to rule out simple fixes:
- Force close the app and reopen it
- Restart your iPhone
- Clear the app cache (Settings > General > Storage > GapFix > Offload App)
- Ensure you have the latest version of GapFix
- Ensure you have updated to the latest iOS version
- Log out and log back in
- Try the same action on a different device if available
- Check your internet connection and try again
If the issue persists after these steps, it is likely a legitimate bug worth reporting.
Support vs. Bug Reports
Know the difference between a bug report and a support request:
Report a bug if:
- The app crashed or froze
- A feature is not working as designed
- Something displays incorrectly
- An error message appears unexpectedly
- Performance is worse than expected
Contact support instead if:
- You cannot log in and forgot your password (use "Forgot Password")
- You need to reset your learning plan
- You have questions about features
- You want to cancel your subscription
- You need to recover your account
- You have general questions
For support issues, email help@gapfix.app or use in-app chat.
Appreciation for Bug Reports
Every bug report helps us make GapFix better for everyone. Thank you for:
- Taking the time to report issues
- Providing detailed information
- Testing beta versions
- Helping us maintain quality
- Being patient while we fix issues
Your feedback directly shapes the future of GapFix.
Was this article helpful?