r3ngine Mobile is the official cross-platform companion app for the r3ngine 3.0 Phoenix Rebirth. Designed for security professionals who need to maintain tactical awareness while away from their terminal, the mobile app provides a high-fidelity, glassmorphic interface to your reconnaissance data.
The mobile app isn't just a viewer; it's a portable command center synchronized with your r3ngine core.
- KPI Command Center: Monitor Targets, Subdomains, Endpoints, and Vulnerabilities at a glance.
- Severity Distribution: Instant visualization of your threat landscape (Critical, High, Medium, Low).
- 7-Day Activity Horizon: Chronological tracking of vulnerability discovery trends.
- Geo-Tactical Asset Mapping: Interactive global positioning of assets with high-performance CSS-animated markers.
- Subdomain Inventory: Browse, search, and filter discovered subdomains on the go.
- Target Profiles: Deep dive into target-specific data, technologies, and vulnerabilities.
- Vulnerability Feed: Real-time biohazard-themed feed of newly discovered threats with severity indicators.
- Live Progress Tracking: Monitor scan pipeline health and completion status in real-time.
- Remote Execution: Initiate quick scans or stop active processes directly from your phone via the unified StopScan API.
- Hardware Profile Selection: Choose specific hardware resource profiles (CPU/RAM limits, worker queues) when starting a scan directly from the mobile interface.
- Scan History: Review historical scan results and summaries with full data persistence.
- Live Log Viewer: Stream scan and system logs in real-time with full ANSI colour support. Colour-coded log lines render directly in-app via WebSocket, so you can watch a running scan's raw output from your device.
- Directories Tab: Fully wired directory discovery view with push-notification alerts on new directory findings.
- Interactive Attack Path Viewer: Navigate full compromise chains from the Intelligence Reports screen. Each node in the path renders custom styled badges with severity colours for Assets, Vulnerabilities, Capabilities, Privileges, and Credentials — including CVSS scores and chain transitions.
- AI-Powered Path Analysis ("Explain This"): Tap the brain icon on any attack path to trigger an LLM-powered tactical narrative. Explanations are persisted server-side and load instantly on repeat views without regeneration.
- Vulnerability Details Modal: Tap VIEW on any enriched vulnerability node inside an attack path to pull full threat-intel (Name, Severity, Domain, URL, Description, Impact, Remediation) directly from the backend.
- On-Demand Recalculation: Trigger a full APME recalculation from the Scan Summary Tab with a single tap, dispatching a background recalculation workflow to the core engine.
- Engines Management: Browse, inspect, and identify scan engine configurations — view task assignments and the active default engine.
- Proxy Control: Toggle global proxy routing, manage your tactical proxy list, and set a Fetch Limit (presets: 5 K / 10 K / 25 K, or custom) to control how many proxies are scraped on demand.
- Monitoring Console: Per-target monitoring toggle with an inline settings modal — enable or disable continuous reconnaissance on any target without leaving the feed.
- Secure Credential Storage: Native integration with Expo SecureStore for API keys and authentication tokens.
- PII Gate Compliance: All mobile communication respects the core's PII gate, ensuring reconnaissance data remains private.
- Authentication Resilience: Hardened login flow with session persistence and automatic redirection.
- Cyberpunk "Neon" Theme: Glassmorphic UI matching the core v3 identity, optimized for dark mode and high-contrast environments.
- Bangers Typography: Tactical header styling using the signature Bangers font.
- Lucide-React-Native Icons: Clean, modern iconography for fast visual recognition.
| Dashboard | Geo-Tactical Map | Scan Details | Scan Orchestration |
|---|---|---|---|
 |
 |
 |
 |
Built with a "Safety-First" philosophy, the mobile app leverages a modern, high-performance stack:
- Framework: Expo (React Native)
- Routing: Expo Router (File-based navigation)
- Data Fetching: TanStack Query v5 (Asynchronous state management)
- State Management: Zustand (Lightweight global state)
- Networking: Axios with centralized interceptors
- Animations: React Native Reanimated
- Icons: Lucide-React-Native & FontAwesome
-
Clone and Navigate
git clone https://github.com/whiterabb17/r3ngine-mobile.git cd r3ngine-mobile -
Install Dependencies
npm install
-
Start Development Server
npx expo start
-
Connect to Backend
- Open the app on your device.
- Enter your r3ngine Core IP/Domain.
- Log in with your standard r3ngine credentials.
r3ngine Mobile acts as a thin client to the r3ngine Core API. It utilizes the same OpenAPI contract as the web frontend, ensuring that every finding discovered by APME, ASRE, or Nuclei is instantly reflected in your hand.
- API Client: Centralized configuration in
src/api/client.ts. - Types: Strictly mapped to
openapi.jsonfor full type safety. - Diagnostics: Built-in connection testing to verify reachability of your r3ngine instance.
Distributed under the GNU GPL v3 License. See the main LICENSE for more information.
Note: This mobile app is a companion to the r3ngine core and requires a running r3ngine instance to function.