"Security tools don’t need to be complex — they need to be clear, effective, and built with purpose."
Click The Below Youtube Link To View Full Phishvault Demonstration.
PhishVault is a secure and intelligent platform to analyze, manage, and investigate potentially malicious URLs. Designed with cybersecurity professionals in mind, it simplifies phishing detection, logging, and reporting in a fast and scalable way.
⚙️ Status:
Stable-v1.0 & Enhancements-v1.0.1 Released
📆 Project Duration: 2 Months
👥 Team Size: 2 Developers 📁 Deployment: Dockerized with CI/CD
🛠 Stack: Node.js, React.js, MongoDB, Docker, Puppeteer
- Submit suspicious URLs for scanning
- Retrieve real-time threat verdicts (Safe / Suspicious / Malicious)
- Filter reports by verdicts and date
- View full scan history and analytical summaries
- Perform full CRUD operations on scan reports
- Gain backend observability and RESTful API access
- 🔐 Threat Intelligence Storage (MongoDB Collections)
- 🎯 Custom Verdict Classification
- 📆 Date-range Report Querying
- 📊 Dashboard Analytics Module
- 🧾 Report Generation via Aggregation Pipelines
- ⚙️ Fastify REST API
- 📦 Dockerized Container System
- 🤖 Puppeteer-based Scan Orchestration
| Component | Technology |
|---|---|
| Frontend | React.js |
| Backend | Fastify (Node.js) |
| Database | MongoDB |
| Scanning | Puppeteer |
| Container | Docker |
Note: Docker image support coming soon! stay tuned.
- Node.js
v18+ - MongoDB (local or Docker)
- Git
- Linux/macOS terminal or WSL (for
.shscript support)
To run locally
git clone https://github.com/your-username/phishvault.git
cd phishvaultIf MongoDB isn’t running locally, you can spin it up using Docker:
docker run -d --name phishvault-mongo -p 27017:27017 mongo
Backend: backend/.env
PORT=4000
MONGO_URI=mongodb://localhost:27017/phishvault
cd phishvault-backend/
./devbackend.shcd phishvault-frontend/
./devfrontend.shany dev issues, reach us out at email or linkedin or here in gitHub
“Every tool should feel intuitive — even when it’s built for complex problems.”
- Defined project scope and vision
- Designed UI/UX and led frontend dev
- Planned API integration and user experience
- Orchestrated team collaboration and progress tracking
“Functionality, observability, and precision — the foundation of secure backend systems.”
- Developed backend logic using Puppeteer
- Designed verdict classification and threat scoring
- Built complete REST API with Fastify
- Engineered MongoDB schema and security layers
- ✅ Backend REST API completed
- ✅ MongoDB schema integrated
- ✅ Puppeteer scan orchestration implemented
- ✅ Verdict classification logic added
- ✅ Report generation via aggregation pipelines
- ✅ CRUD support for scan reports
- ✅ Dashboard analytics module
- ✅ Docker containerization
- ✅ CI/CD setup (GitLab)
- ✅ Final QA, testing, and cleanup
- ✅ v1.0 Released
- ✅ v1.0.1 Enhancements Released
PhishVault is intended strictly for ethical research, threat detection training, and cybersecurity education.
For bug reports, contributions, or collaboration requests:
- 🔄 Clear division of frontend & backend roles
- 🔐 Security-first development methodology
- ⚡ Rapid prototyping + CI/CD for faster iteration
- 📦 Scalable architecture with future extensibility in mind
Refer ChangeLog for more info.
“PhishVault isn’t just a project. It’s proof that even a small, focused team can build something powerful, intuitive, and security-driven.” Repository Created: May 28, 2025
© 2025 PhishVault – Built with intent. Released with purpose.