System Manual
Comprehensive reference guides for native companion Android tools, API configuration, secrets isolation, and system architecture standards.
Companion Native Android Suite
FloatAssist
A floating ball overlay for Android offering a quick-access system launcher and development Pod controller anywhere on your device.
-
•
System Overlay Permission: Grants
SYSTEM_ALERT_WINDOWpermission on first launch. - • System Pod Shortcut: Tap the floating ball to expand the Pod grid, launch Conjure OS, or execute quick commands.
- • Throttled Touch Coordinates: Hardware drag gestures are throttled to 60fps to prevent frame drops.
KeyMapper
Connects physical phone hardware buttons directly to background system triggers without requiring screen interaction.
- • AccessibilityService API: Listens for hardware button press events (Volume rocker, Power, or dedicated keys).
- • Stealth Audio Recording: Hold down a mapped hardware key to capture voice notes instantly with a blank screen.
- • Remote Upload Bridge: Transcribes raw audio via OpenRouter and streams text into your inbox stream.
ApkWrapper
Works with AppMaker and Orbit to automatically detect your local or cloud-deployed web apps, hosting them inside dedicated standalone browser wrappers designed specifically for full-screen performance.
- • Native Android Multitasking: Integrates seamlessly with Android split-screen, picture-in-picture, and floating windows far better than standard mobile browsers like Chrome or Edge.
- • True Aesthetic Full-Screen: Mounts web apps in borderless, edge-to-edge full-screen without browser address bars or navigation clutter.
- • Isolated Per-App Cache & Cookies: Each wrapper maintains its own isolated storage—allowing you to clear cache or cookies during app development without affecting other web apps or sites.
-
•
WebBridge JNI: Exposes native Java methods as a global
window.Androidobject.
API Keys, Secrets & Configuration
Server-Side Secret Isolation Architecture
To guarantee privacy and prevent accidental API key leaks during system backups or clean context exports, all persistent application settings, secrets, and keys MUST be stored server-side under app/data/ or apps/[Folder]/data/ using dedicated JSON formats.
Configure your OpenRouter API key inside app/data/openrouter-private.json:
{ "api_key": "sk-or-v1-your-key-here" }
All files ending with -private.json (such as backend-private.json) are automatically excluded from clean ZIP exports and cloud backups to prevent key leakage.
System Architecture & AI Protocols
Modifications are executed using surgical #FIND / #REPLACE diff blocks wrapped in triple tildes. Unchanged lines remain untouched, preventing code evaporation and preserving exact line anchors.
Inner code logic is compressed into structural signatures (/* [Impl hidden] */), achieving ~90% token savings and allowing the AI to inspect 50+ files in a single prompt before pulling full source files for patching.