Skip to content

Adhi-crypto/NetReconScanner

Repository files navigation

🔐 NetReconScanner — Automated Network Reconnaissance Dashboard

NetReconScanner is a full-stack cybersecurity web application designed for ethical network reconnaissance and educational security analysis. It combines a modern React + TypeScript dashboard with an Express/Nmap backend to perform automated scans, visualize open ports, and generate structured security reports.


🚀 Features

  • 🌐 Modern cybersecurity-themed dashboard (Vite + Tailwind CSS)

  • 🔎 Automated network scanning using Nmap

  • ⚡ Scan Profiles:

    • Quick Scan
    • Service Detection
    • Deep Scan
  • 🧠 Risk Level Indicators for open ports

  • 🖥️ Live terminal-style scan logs

  • 📊 Real-time results visualization

  • 🧾 JSON / PDF report export

  • 🔐 Authentication-ready architecture

  • 🗂️ Scan history tracking


🏗️ Project Architecture

NetReconScanner/
│
├── client/     → React + TypeScript frontend
├── server/     → Express API & scanning logic
├── shared/     → Common utilities & types
└── netlify/    → Deployment configuration

⚙️ Tech Stack

  • React + TypeScript
  • Vite
  • Tailwind CSS
  • Node.js + Express
  • Nmap Integration
  • REST API Architecture

📸 Dashboard Overview

This project simulates a Security Operations Center (SOC)-style interface, allowing users to:

  • Enter IP address or subnet targets
  • Launch automated scans
  • View open ports with service details
  • Monitor scan progress in real-time

⚠️ Ethical Use Disclaimer

This tool is built strictly for educational and authorized security testing. Only scan systems and networks that you own or have explicit permission to test.


🧑‍💻 Developer

Adhi Cybersecurity & Artificial Intelligence Student

Adhi focuses on building practical security tools and intelligent systems. Passionate about ethical hacking, network reconnaissance, and secure full-stack development, this project demonstrates hands-on experience creating real-world cybersecurity dashboards.

🔗 GitHub: https://github.com/Adhi-crypto

💡 Skills Used

React TypeScript Express Nmap Python Cybersecurity Full-Stack Development


▶️ Getting Started (Local Setup)

1️⃣ Clone Repository

git clone https://github.com/Adhi-crypto/NetReconScanner.git
cd NetReconScanner

2️⃣ Install Dependencies

npm install

3️⃣ Run Development Server

npm run dev

🌍 Deployment

Frontend can be deployed via Netlify or Vercel. Backend API can be hosted using Render or similar Node.js hosting platforms.


⭐ Project Goal

To demonstrate real-world cybersecurity engineering skills by building a production-style reconnaissance dashboard that combines secure backend scanning with an interactive web interface.


📜 License

This project is intended for educational and ethical cybersecurity research.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages