# Build Instructions for Dark Side Admin APK

## ⚠️ Important: This is a Custom Build

This version of SilverDROID loads `https://admin.dark.side` directly on launch.

---

## Option 1: Build with Android Studio (Recommended)

### Steps:

1. **Open Project**
   ```
   C:\Production\Source\SilverLABS\SilverDROID
   ```
   - Launch Android Studio
   - File → Open → Select `SilverDROID` folder

2. **Sync Gradle**
   - Wait for automatic Gradle sync (~2-5 minutes)
   - If prompted, click "Sync Now"

3. **Build APK**
   - Build → Build Bundle(s) / APK(s) → Build APK(s)
   - Wait for build to complete
   - Click "locate" in notification to find APK

4. **APK Location**
   ```
   app\build\outputs\apk\debug\app-debug.apk
   ```

---

## Option 2: Build from Command Line (Windows PowerShell)

### Prerequisites:
- Android SDK installed
- `ANDROID_HOME` environment variable set

### Steps:

1. **Open PowerShell**
   ```powershell
   cd C:\Production\Source\SilverLABS\SilverDROID
   ```

2. **Download Gradle Wrapper** (first time only)
   ```powershell
   # Download Gradle distribution
   Invoke-WebRequest -Uri "https://services.gradle.org/distributions/gradle-8.9-bin.zip" -OutFile "gradle.zip"

   # Extract
   Expand-Archive -Path "gradle.zip" -DestinationPath "." -Force

   # Create wrapper
   .\gradle-8.9\bin\gradle.bat wrapper

   # Cleanup
   Remove-Item gradle.zip
   Remove-Item -Recurse -Force gradle-8.9
   ```

3. **Build Debug APK**
   ```powershell
   .\gradlew.bat assembleDebug
   ```

4. **Output Location**
   ```
   app\build\outputs\apk\debug\app-debug.apk
   ```

---

## Option 3: Use TeamCity CI/CD

Upload the project to GitLab and configure TeamCity:

**GitLab:** https://gitlab.silverlabs.uk
**TeamCity:** https://cis1.silverlabs.uk

### TeamCity Build Steps:
```kotlin
steps {
    gradle {
        tasks = "clean assembleDebug"
        gradleWrapperPath = ""
    }
}
```

---

## Installing the APK

### On Physical Device:
1. Copy `app-debug.apk` to your device
2. Tap the APK file
3. Allow "Install from Unknown Sources" if prompted
4. Tap "Install"

### Via ADB:
```powershell
adb install app\build\outputs\apk\debug\app-debug.apk
```

---

## What This Build Does

- ✅ Loads `https://admin.dark.side` immediately on launch
- ✅ Bypasses the launcher screen
- ✅ Full WASM/PWA support enabled
- ✅ Glassmorphism UI for top bar
- ✅ Back button exits the app

---

## Customization

To change the URL, edit:
```
app/src/main/kotlin/uk/silverlabs/silverdroid/MainActivity.kt
```

Line 23:
```kotlin
private val targetUrl = "https://admin.dark.side"
```

Change to your desired URL and rebuild.

---

## Troubleshooting

### "SDK location not found"
Set `ANDROID_HOME`:
```powershell
[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "C:\Users\YourUser\AppData\Local\Android\Sdk", "User")
```

### "Gradle sync failed"
1. Check internet connection
2. Delete `.gradle` folder
3. Restart Android Studio
4. Try sync again

### "Build failed"
1. Check JDK version: `java -version` (must be 17+)
2. Clean project: `.\gradlew.bat clean`
3. Rebuild: `.\gradlew.bat assembleDebug`

---

## Build Configuration

- **Package Name:** `uk.silverlabs.silverdroid`
- **App Name:** "Dark Side Admin"
- **Min SDK:** 26 (Android 8.0)
- **Target SDK:** 35 (Android 15)
- **Version:** 1.0.0

---

Need help? Check the main README.md or contact SilverLABS support.