SilverDROID/QUICKSTART.md

# SilverDROID - Quick Start Guide

## 🚀 5-Minute Setup

### Option 1: Android Studio (Recommended)

1. **Open Project**
   ```bash
   # From WSL
   cd /mnt/c/Production/Source/SilverLABS/SilverDROID
   ```
   - Launch Android Studio
   - Click "Open"
   - Navigate to `SilverDROID` folder
   - Click "OK"

2. **Wait for Sync**
   - Gradle will sync automatically (~2-5 minutes first time)
   - Status shown in bottom status bar

3. **Run the App**
   - Click the green ▶️ (Run) button
   - Select your device/emulator
   - App will build and install

### Option 2: Command Line

```bash
cd /mnt/c/Production/Source/SilverLABS/SilverDROID

# Build and install
./gradlew installDebug

# Or build only
./gradlew assembleDebug
```

## 📱 First Launch

### What You'll See
1. **Glassmorphism Background** - Gradient with frosted glass effect
2. **"No Apps Yet" Screen** - Empty state with add button
3. **+ Button** - Floating action button (bottom-right)

### Add Your First App

1. **Tap the + Button**
2. **Enter a URL**
   - Try: `https://mobile.twitter.com`
   - Or: `https://m.youtube.com`
   - Or: `https://webassembly.org/demo/`
3. **Tap "Add"**
4. **See Your App** - Glass card appears in grid
5. **Tap the Card** - Opens in full-screen WebView

## 🎨 What Makes It Special?

### Glassmorphism Effects
- **Frosted Glass Cards** - Semi-transparent app cards
- **Blur Effects** - Background blur on panels
- **Gradient Background** - Animated color gradient
- **Border Glow** - Subtle borders on glass elements

### PWA/WASM Features
- **Offline Support** - Apps work without internet
- **Service Workers** - Background sync
- **Full-Screen Mode** - Immersive app experience
- **WASM Execution** - Fast WebAssembly performance

## 🔧 Development Tips

### Hot Reload (Sort of)
Compose supports limited hot reload:
1. Make UI changes in `.kt` files
2. Click ⚡ "Apply Changes" button
3. Some changes apply without rebuild

### WebView Debugging
1. Open Chrome on your PC
2. Navigate to `chrome://inspect`
3. Find "SilverDROID" under "Remote Target"
4. Click "inspect"
5. Full DevTools for PWA debugging!

### Database Inspection
```bash
# Pull database from device
adb pull /data/data/uk.silverlabs.silverdroid/databases/pwa_database ./

# Open with SQLite browser
sqlite3 pwa_database
.tables
SELECT * FROM pwa_apps;
```

## 📝 Sample Apps to Try

### PWAs
- **Twitter**: `https://mobile.twitter.com`
- **Spotify**: `https://open.spotify.com`
- **YouTube**: `https://m.youtube.com`
- **Instagram**: `https://www.instagram.com`
- **Notion**: `https://www.notion.so`

### WASM Demos
- **WebAssembly.org Demo**: `https://webassembly.org/demo/`
- **Figma**: `https://www.figma.com` (uses WASM)
- **Google Earth**: `https://earth.google.com/web/`
- **Photopea**: `https://www.photopea.com` (Photoshop in browser)

## 🐛 Troubleshooting

### "Gradle Sync Failed"
```bash
# Clean and rebuild
./gradlew clean build
```

### "Device Not Found"
```bash
# Check connected devices
adb devices

# If empty, enable USB debugging on your Android device:
# Settings → About Phone → Tap "Build Number" 7 times
# Settings → Developer Options → Enable "USB Debugging"
```

### "Build Failed"
1. Check JDK version: `java -version` (must be 17+)
2. Update Android Studio to latest
3. Invalidate caches: File → Invalidate Caches / Restart

### WebView Not Loading
- Check internet connection
- Verify URL starts with `https://`
- Try a different URL
- Check device logs: `adb logcat | grep SilverDROID`

## 🎯 Project Structure (Quick Reference)

```
SilverDROID/
├── app/src/main/kotlin/uk/silverlabs/silverdroid/
│   ├── MainActivity.kt              # Entry point
│   ├── ui/launcher/                 # Main screen
│   ├── ui/webview/                  # PWA container
│   ├── ui/components/               # Glass components
│   ├── ui/theme/                    # Theming
│   └── data/                        # Database
├── build.gradle.kts                 # Build config
└── README.md                        # Full docs
```

## 📚 Next Steps

1. **Customize Colors**
   - Edit `ui/theme/Color.kt`
   - Change glass tint/opacity
   - Adjust Material Design colors

2. **Add Features**
   - Settings screen
   - Icon caching
   - Categories/tags
   - Search functionality

3. **Deploy**
   - Build release APK: `./gradlew assembleRelease`
   - Sign with your keystore
   - Distribute or publish

## 💡 Pro Tips

### Fast Iteration
1. Keep Android Studio open
2. Make changes in `.kt` files
3. Use "Apply Changes" (⚡) instead of full rebuild
4. Test on real device for better performance

### Glass Effects
- Adjust blur radius in `GlassComponents.kt`
- Modify alpha values for transparency
- Experiment with gradient colors in `GlassBackground`

### Performance
- Test on real devices (emulator is slower)
- Profile with Android Profiler
- Monitor WebView memory usage
- Optimize large app lists (already using LazyGrid)

---

## 🎉 That's It!

You now have a working Android PWA/WASM launcher with glassmorphism UI!

**Questions?** Check the full README.md or PROJECT_SUMMARY.md

**Issues?** https://gitlab.silverlabs.uk/SilverLABS/silverdroid/issues

---

**Built with ❤️ by SilverLABS**