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:
163
QUICK_REFERENCE.md
Normal file
163
QUICK_REFERENCE.md
Normal 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! 🚀
|
||||
Reference in New Issue
Block a user