SilverDROID/DARK_SIDE_BUILD.md

Dark Side Admin - Custom Build Summary

🎯 What Was Created

A specialized version of SilverDROID that loads https://admin.dark.side directly on launch, with full WASM/PWA support and glassmorphism UI.

---

📦 Project Status

✅ Completed

• Android project structure created
• MainActivity modified to auto-load admin.dark.side
• WebView optimized for WASM/PWA
• Glassmorphism UI theme applied
• App name changed to "Dark Side Admin"
• All dependencies configured

📱 Ready for Compilation

The project is ready to build but requires:

1. Android Studio (to compile)
2. Android SDK installed
3. JDK 17+ installed

---

🏗️ How to Build

Recommended: Android Studio

1. Open Android Studio

   • File → Open
   • Navigate to: C:\Production\Source\SilverLABS\SilverDROID

2. Sync Gradle (automatic, ~2-5 minutes)

3. Build APK

   • Build → Build Bundle(s) / APK(s) → Build APK(s)

4. Find APK

   app\build\outputs\apk\debug\app-debug.apk
   

Alternative: PowerShell Command Line

cd C:\Production\Source\SilverLABS\SilverDROID

# First time: Create Gradle wrapper
.\gradlew.bat wrapper

# Build APK
.\gradlew.bat assembleDebug

---

🎨 What's Included

Core Features

• ✅ Direct URL Loading - Opens admin.dark.side immediately
• ✅ WASM Support - WebAssembly fully enabled
• ✅ PWA Features - Service Workers, offline caching
• ✅ DOM Storage - LocalStorage, SessionStorage enabled
• ✅ JavaScript - Fully enabled
• ✅ Mixed Content - HTTP/HTTPS allowed (for dev)

UI Features

• ✅ Glassmorphism Theme - Frosted glass effects
• ✅ Material Design 3 - Modern Android design
• ✅ Dark/Light Theme - Adapts to system settings
• ✅ Progress Indicator - Loading states
• ✅ Back Navigation - Back button exits app
• ✅ Refresh Button - Reload the page
• ✅ Title Bar - Shows page title

WebView Configuration

settings.javaScriptEnabled = true
settings.domStorageEnabled = true
settings.databaseEnabled = true
settings.allowFileAccess = true
settings.allowContentAccess = true
settings.mixedContentMode = MIXED_CONTENT_ALWAYS_ALLOW
settings.cacheMode = LOAD_DEFAULT
settings.setAppCacheEnabled(true)

---

📁 Key Files Modified

MainActivity.kt

Changed: Now loads admin.dark.side directly instead of showing launcher

private val targetUrl = "https://admin.dark.side"
private val appName = "Dark Side Admin"

strings.xml

Changed: App name from "SilverDROID" to "Dark Side Admin"

<string name="app_name">Dark Side Admin</string>

All Other Files

Unchanged: Theme, WebView, components all intact

---

🔧 WebView Debugging

Enable Chrome DevTools

1. Build and install the app
2. Open Chrome on your PC
3. Navigate to: chrome://inspect
4. Find "Dark Side Admin" under "Remote Target"
5. Click "inspect"

Now you have full DevTools:

• Console
• Network tab
• Elements inspector
• Performance profiler

---

📱 App Specifications

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

Target URL: https://admin.dark.side

Permissions:
  - INTERNET
  - ACCESS_NETWORK_STATE
  - POST_NOTIFICATIONS
  - Storage (for caching)

---

🚀 Installation

On Device

1. Build the APK (see above)
2. Copy to device via USB or cloud
3. Tap the APK file
4. Allow "Install from Unknown Sources"
5. Tap "Install"

Via ADB

adb install app/build/outputs/apk/debug/app-debug.apk

---

🔐 Security Notes

Cleartext Traffic

Currently enabled for development. For production:

Edit AndroidManifest.xml:

android:usesCleartextTraffic="false"

Mixed Content

Currently allows HTTP/HTTPS mixing. For production, change WebView settings:

settings.mixedContentMode = WebSettings.MIXED_CONTENT_NEVER_ALLOW

ProGuard

Release builds use ProGuard for code obfuscation and optimization.

---

📊 Build Outputs

Debug Build

• File: app-debug.apk
• Size: ~10-15 MB
• Debuggable: Yes
• Optimized: No
• Location: app/build/outputs/apk/debug/

Release Build

.\gradlew.bat assembleRelease

• File: app-release-unsigned.apk
• Size: ~8-10 MB
• Debuggable: No
• Optimized: Yes (ProGuard)
• Location: app/build/outputs/apk/release/

---

⚙️ Customization

Change Target URL

Edit MainActivity.kt line 23:

private val targetUrl = "https://your-new-url.com"

Change App Name

Edit res/values/strings.xml:

<string name="app_name">Your App Name</string>

Change Package Name

1. Refactor package in Android Studio
2. Update build.gradle.kts:

   applicationId = "com.yourcompany.appname"
   

---

🐛 Troubleshooting

Build Errors

"SDK location not found"

# Set ANDROID_HOME environment variable
$env:ANDROID_HOME = "C:\Users\YourUser\AppData\Local\Android\Sdk"

"Gradle sync failed"

1. Check internet connection
2. File → Invalidate Caches / Restart

"JDK version incompatible"

• Need JDK 17 or later
• Download from: https://adoptium.net/

Runtime Errors

"App won't load URL"

• Check internet connection
• Verify URL is accessible in browser
• Check logcat: adb logcat | grep SilverDROID

"WebView blank"

• Clear app data: Settings → Apps → Dark Side Admin → Clear Data
• Try different URL to test

---

📞 Support

Resources

• Main README: README.md
• Build Guide: BUILD.md
• Quick Start: QUICKSTART.md
• Project Summary: PROJECT_SUMMARY.md

SilverLABS Infrastructure

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

---

✅ Build Checklist

• Project structure created
• MainActivity modified for direct load
• App name changed
• WebView configured for WASM
• Glassmorphism theme applied
• Gradle wrapper created
• Build scripts ready
• Compile in Android Studio ← Next Step
• Install on device
• Test admin.dark.side loading

---

🎉 Summary

You now have a fully configured Android project that:

• Loads https://admin.dark.side on launch
• Supports WASM and PWAs
• Has beautiful glassmorphism UI
• Is ready to compile

Next step: Open in Android Studio and build the APK!

---

Built for SilverLABS | Custom Dark Side Admin Loader