Troubleshooting

Common Issues

App not loading

• Check Firebase deploy status
• Run npm run build and redeploy

QR/Barcode scanner not working

• Ensure camera permissions are granted
• Test on a supported mobile device

GPS not available

• Only works on mobile browsers/devices
• Check device location settings

Docs not showing on GitHub Pages

• Ensure gh-pages branch is published in repo settings
• Run python -m mkdocs gh-deploy --force after changes

Getting Help

• Check logs in browser console
• Review Firebase and GitHub Actions logs
• Open an issue on GitHub