SSC / PWA_INSTALLATION_GUIDE.md
Hkoradiya123
feat: Add Firebase user management scripts and PWA enhancements
48eca97
|
Raw History Blame Contribute Delete
3.41 kB
# PWA Installation Guide - SSC (Sculpt Soft Cricketers)
## What is a PWA?
A **Progressive Web App (PWA)** is a web application that can be installed on your device like a native app. It provides:
- โœ… Fast loading times
- โœ… Offline functionality
- โœ… Push notifications support
- โœ… Home screen icon
- โœ… Full-screen experience (no browser bar)
---
## How to Install SSC App
### **On Android (Chrome, Edge, Opera)**
1. **Look for the install banner** at the bottom of the screen
- Or tap the menu icon (โ‹ฎ) in the top-right corner
2. **Tap "Install" or "Install app"**
- Confirm any prompts
3. **The app will be added to your home screen**
- You can now open it like any other app
### **On iOS (Safari)**
1. **Tap the Share button** (square with arrow โ†—๏ธ)
2. **Scroll down and tap "Add to Home Screen"**
3. **Enter a name** (or keep "SSC")
4. **Tap "Add"** to confirm
5. **The app will appear on your home screen**
- Open it anytime like a regular app
### **On Desktop/Windows (Chrome, Edge)**
1. **Look for the install icon** in the address bar (usually on the right side)
- Or use the menu โ†’ "Install SSC"
2. **Click the icon to install**
3. **Confirm the installation**
4. **The app will launch in a window** without the browser bar
### **On macOS (Safari, Chrome)**
1. **Same as Desktop Windows steps above**
- Or use Safari menu โ†’ File โ†’ "Add to Dock" (if available)
---
## Features After Installation
Once installed, you get:
### **โœจ Better Performance**
- Faster loading from cache
- Works instantly on return visits
### **๐Ÿ“ฑ App Experience**
- No browser address bar
- Full screen experience
- Feels like a native app
### **๐ŸŒ Offline Support**
- View previously loaded matches
- Queue actions while offline
- Auto-sync when reconnected
### **๐Ÿ”” Quick Access**
- Home screen icon
- App switcher access
- Faster than bookmarks
---
## Troubleshooting
### **"Install" option not showing?**
- **Android**: Make sure you're using Chrome, Edge, or Opera
- **iOS**: Must use Safari; Chrome doesn't support PWA installation on iOS
- **Desktop**: Try using Chrome or Edge instead of Firefox
### **App not working offline?**
- Some features require internet (live scoring, sync)
- Basic match viewing should work offline
- Reload the app to force cache update
### **Want to remove the app?**
- **Android**: Long-press the app icon โ†’ "Uninstall"
- **iOS**: Long-press the app icon โ†’ "Remove App" โ†’ "Remove from Home Screen"
- **Desktop**: Remove like any other application from your system
---
## How PWA Works
The app uses:
- **Service Worker**: Caches app files for faster loading
- **Manifest**: Defines app metadata (name, icons, colors)
- **HTTPS**: Secure connection for safe installation
All your data is stored locally in your browser and synced with our servers when online.
---
## Security & Privacy
- โœ… All data encrypted in transit (HTTPS)
- โœ… Local storage is separate per device
- โœ… No tracking or ads
- โœ… Same privacy policy as web version
---
## Questions?
For technical issues:
1. **Clear app cache**: Settings โ†’ Apps โ†’ SSC โ†’ Storage โ†’ Clear Cache
2. **Reinstall**: Uninstall and install again from the address bar
3. **Update**: The app auto-updates in the background
4. **Fallback**: Visit the web version at https://ssc.app
---
**Enjoy SSC in app form!** ๐Ÿ