https://github.com/whiterabb17/r3ngine-mobile
r3NgineMobile Companion [Android|iOS] Tactical Reconnaissance Interface in Your Pocket. Designed for security professionals who need to maintain tactical awareness while away from their terminal, the mobile app provides a high-fidelity interface to your recon data
https://github.com/whiterabb17/r3ngine-mobile
cyber-threat-intelligence cybersecurity mobile-penetration-testing mobile-pentest-toolkit mobile-recon mobile-soc pentesting-tools reconnaissance redteam rengine rengine-ng soc
Last synced: 17 days ago
JSON representation
r3NgineMobile Companion [Android|iOS] Tactical Reconnaissance Interface in Your Pocket. Designed for security professionals who need to maintain tactical awareness while away from their terminal, the mobile app provides a high-fidelity interface to your recon data
- Host: GitHub
- URL: https://github.com/whiterabb17/r3ngine-mobile
- Owner: whiterabb17
- Created: 2026-05-11T18:34:52.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-31T06:52:55.000Z (27 days ago)
- Last Synced: 2026-05-31T08:15:35.845Z (26 days ago)
- Topics: cyber-threat-intelligence, cybersecurity, mobile-penetration-testing, mobile-pentest-toolkit, mobile-recon, mobile-soc, pentesting-tools, reconnaissance, redteam, rengine, rengine-ng, soc
- Language: TypeScript
- Homepage:
- Size: 15 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Phoenix: From the Ashes even Stronger
Official v3 Mobile Companion: The Tactical Reconnaissance Interface in Your Pocket 🚀
r3ngine Mobile: Tactical Reconnaissance 3.0
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 Tactical Advantage: Core Features
The mobile app isn't just a viewer; it's a portable command center synchronized with your r3ngine core.
### 🧠 Real-Time Intelligence Dashboard
* **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.
### 🕵️ Surgical Asset Management
* **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.
### 🌪️ Scan Orchestration & Control
* **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.
### ⚙️ Infrastructure & Settings
* **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.
### 🥷 Stealth & Security
* **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.
### 🎨 Premium Visual Experience
* **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.
## 📸 Visual Interface
| Dashboard | Geo-Tactical Map | Scan Details | Scan Orchestration |
| :---: | :---: | :---: | :---: |
| 
| 
| 
| 
|
## 🛠️ Technology Stack
Built with a "Safety-First" philosophy, the mobile app leverages a modern, high-performance stack:
* **Framework**: [Expo](https://expo.dev/) (React Native)
* **Routing**: [Expo Router](https://docs.expo.dev/router/introduction/) (File-based navigation)
* **Data Fetching**: [TanStack Query v5](https://tanstack.com/query/latest) (Asynchronous state management)
* **State Management**: [Zustand](https://github.com/pmndrs/zustand) (Lightweight global state)
* **Networking**: [Axios](https://axios-http.com/) with centralized interceptors
* **Animations**: [React Native Reanimated](https://docs.swmansion.com/react-native-reanimated/)
* **Icons**: [Lucide-React-Native](https://lucide.dev/) & [FontAwesome](https://fontawesome.com/)
## 🚀 Quick Installation (Development)
### Prerequisites
* Node.js (LTS)
* Expo Go app on your [iOS](https://apps.apple.com/app/expo-go/id982107779) or [Android](https://play.google.com/store/apps/details?id=host.exp.exponent) device.
### Setup
1. **Clone and Navigate**
```bash
git clone https://github.com/whiterabb17/r3ngine-mobile.git
cd r3ngine-mobile
```
2. **Install Dependencies**
```bash
npm install
```
3. **Start Development Server**
```bash
npx expo start
```
4. **Connect to Backend**
* Open the app on your device.
* Enter your **r3ngine Core IP/Domain**.
* Log in with your standard r3ngine credentials.
## 🧭 Workflow Integration
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.json` for full type safety.
* **Diagnostics**: Built-in connection testing to verify reachability of your r3ngine instance.
## 🛡️ License
Distributed under the **GNU GPL v3 License**. See the main [LICENSE](../LICENSE) for more information.
Note: This mobile app is a companion to the r3ngine core and requires a running r3ngine instance to function.