SilverDROID - Dark Side Admin with CI/CD pipeline

- Android PWA/WASM launcher with glassmorphism UI
- Loads https://admin.dark.side directly on launch
- Complete GitLab CI/CD pipeline configuration
- Automated builds for Debug, Release, and AAB
- Full WASM support with optimized WebView
- Material Design 3 theme
- Comprehensive documentation

Features:
- Auto-load target URL on app launch
- Glassmorphism components (frosted glass effects)
- Full PWA/WASM support
- Room database for future extensions
- Jetpack Compose UI
- CI/CD with artifact storage

Built for SilverLABS
This commit is contained in:
2025-09-30 17:13:14 +01:00
commit c667765488
41 changed files with 4857 additions and 0 deletions

163
QUICK_REFERENCE.md Normal file
View File

@@ -0,0 +1,163 @@
# 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! 🚀