Skip to content

Conversation

@ecapuano
Copy link
Collaborator

Summary

  • Adds full PWA support to DetectionForge, allowing users to install it as a standalone application
  • Maintains internet connectivity requirement (no offline mode) as the app depends on LimaCharlie API

Changes

  • ✅ Installed and configured vite-plugin-pwa for automated PWA generation
  • ✅ Enhanced manifest.json with complete PWA properties
  • ✅ Added PWA-specific meta tags for cross-platform support
  • ✅ Implemented custom install prompt component with smart dismissal
  • ✅ Configured service worker for static asset caching only
  • ✅ Added debugging tools for PWA troubleshooting
  • ✅ Created icon generation scripts for future use

Benefits

  • Installable: Users can install DetectionForge like a native app
  • Faster Loading: Static assets are cached for improved performance
  • Native Experience: Runs in standalone window without browser chrome
  • Auto Updates: Service worker handles seamless updates
  • Cross-Platform: Works on Windows, macOS, Linux, iOS, and Android

Testing

  • Tested PWA installation in development mode
  • Verified service worker registration and caching
  • Confirmed install prompt behavior
  • Validated manifest and meta tags

Notes

  • Current icons use SVG fallback; PNG icons can be generated using provided scripts
  • No offline functionality as the app requires API connectivity
  • Install prompt respects user dismissal with 7-day cooldown

ecapuano added 3 commits July 16, 2025 22:39
- Install vite-plugin-pwa for automated PWA generation
- Update manifest.json with complete PWA properties
- Add multiple icon sizes for different platforms
- Configure service worker with minimal caching strategy
- Add PWA install prompt component
- Update HTML with PWA-specific meta tags
- Configure auto-update behavior for seamless updates

The app now supports installation as a standalone application
while maintaining internet connectivity requirement for API access.
- Add debug button in development mode to check PWA status
- Add console logging for troubleshooting install prompt
- Configure module type for dev service worker
- Add methods to manually trigger install prompt for testing
- Remove incorrectly sized icon references from manifest
- Use SVG icon with 'any' size for better compatibility
- Add mobile-web-app-capable meta tag
- Enhance debug info with browser detection
- Add browser-specific installation instructions
- Remove placeholder PNG icons that were causing errors
@ecapuano ecapuano closed this Jul 17, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants