# SilverDROID - Quick Reference Card

## 🚀 Push to GitLab (First Time)

```bash
# WSL/Linux
./push-to-gitlab.sh

# Windows PowerShell
.\push-to-gitlab.ps1
```

---

## 🏗️ Build Locally

```bash
# Debug APK
./gradlew assembleDebug

# Release APK
./gradlew assembleRelease

# Install on device
adb install app/build/outputs/apk/debug/app-debug.apk
```

---

## 🔧 GitLab URLs

**Project:** https://gitlab.silverlabs.uk/SilverLABS/silverdroid

**Pipelines:** https://gitlab.silverlabs.uk/SilverLABS/silverdroid/-/pipelines

**Jobs:** https://gitlab.silverlabs.uk/SilverLABS/silverdroid/-/jobs

**Latest Debug APK:**
```
https://gitlab.silverlabs.uk/SilverLABS/silverdroid/-/jobs/artifacts/main/raw/app/build/outputs/apk/debug/app-debug.apk?job=build:debug
```

---

## 📦 CI/CD Pipeline

**Trigger:** Push to any branch

**Stages:**
1. prepare (1 min) - Cache dependencies
2. test (2 min) - Lint + unit tests
3. build (3-5 min) - Build APKs
4. deploy (30 sec) - Store artifacts

**Total:** ~5-8 minutes

---

## 🎯 What the App Does

- Loads **https://admin.dark.side** on launch
- Full **WASM/PWA** support
- **Glassmorphism** UI theme
- Back button exits app

---

## 📱 App Info

**Package:** uk.silverlabs.silverdroid
**Name:** Dark Side Admin
**Min Android:** 8.0 (API 26)
**Target:** Android 15 (API 35)

---

## 🔑 GitLab Access

**URL:** https://gitlab.silverlabs.uk
**Token:** glpat-wqUcD7mg53F1mgM-N-PdiW86MQp1OjEH.01.0w074ox93
**SSH Port:** 2223

---

## 📚 Documentation

| File | Purpose |
|------|---------|
| **README.md** | Full project docs |
| **DARK_SIDE_BUILD.md** | Custom build guide |
| **GITLAB_CICD_SETUP.md** | CI/CD setup |
| **CICD_SUMMARY.md** | Pipeline overview |
| **BUILD.md** | Build instructions |
| **QUICKSTART.md** | 5-min getting started |

---

## 🛠️ Key Files

```
MainActivity.kt          - Loads admin.dark.side
WasmWebView.kt          - WebView with WASM support
GlassComponents.kt      - Glassmorphism UI
.gitlab-ci.yml          - CI/CD pipeline
```

---

## ⚡ Quick Commands

```bash
# Build debug
./gradlew assembleDebug

# Run tests
./gradlew test

# Lint check
./gradlew lint

# Clean build
./gradlew clean build

# Install on device
./gradlew installDebug
```

---

## 🎨 Customize Target URL

Edit `MainActivity.kt` line 23:
```kotlin
private val targetUrl = "https://your-url-here"
```

---

## 🐛 Troubleshooting

**Can't build?**
- Open in Android Studio
- File → Sync Project with Gradle Files

**Pipeline not starting?**
- Check Runner: Settings → CI/CD → Runners
- Verify `.gitlab-ci.yml` exists

**APK won't install?**
- Enable "Unknown Sources" on device
- Settings → Security → Unknown Sources

---

## 📞 Support

**GitLab:** https://gitlab.silverlabs.uk
**TeamCity:** https://cis1.silverlabs.uk
**Knowledge:** ~/.claude/Knowledge/

---

**Next Step:** Run `./push-to-gitlab.sh` to get started! 🚀