Advanced online virus scanner and malware detection tool powered by Firebase and VirusTotal API. Analyze suspicious files, domains, IPs and URLs to detect security threats with CORS-free architecture.
- 📁 File Scanning - Upload files up to 32MB with drag & drop support
- 🔗 URL Scanning - Analyze suspicious URLs in real-time
- 🔍 Smart Search - Lookup domains, IPs, and file hashes
- 🔄 Real-time Analysis - Live threat detection and progress tracking
- 📊 Detailed Reports - Comprehensive security analysis from multiple engines
- 🚀 Firebase Powered - Analytics and ready for authentication
- 🌐 CORS Solution - Seamless API integration with CORS proxy
- Frontend: React 18 + TypeScript
- Styling: Tailwind CSS
- Build Tool: Vite
- Backend: Firebase (Analytics, Auth, Firestore, Storage)
- API: VirusTotal API v3
- Routing: React Router v6 (v7 ready)
- CORS Proxy: Custom Cloudflare Worker
- Node.js 16+ and npm
- VirusTotal API key (Get one here)
- Firebase CLI (optional, for deployment)
- Clone the repository:
git clone https://github.com/abhiyanpa/cruzescan.git
cd cruzescan- Install dependencies:
npm install-
Add your VirusTotal API key:
- Open
src/utils/api.ts - Replace
const VIRUSTOTAL_API_KEY = '';with your actual API key
- Open
-
Start development server:
npm run dev- Open your browser:
- Navigate to
http://localhost:5173
- Navigate to
- 📋 Quick Start Guide - Get up and running in 5 minutes
- 🔥 Firebase Conversion - Technical details of Firebase integration
- 🚀 Deployment Guide - Step-by-step deployment instructions
npm run dev # Start development server
npm run build # Build for production
npm run preview # Preview production build
npm run lint # Lint code
npm run deploy # Build and deploy to Firebase
npm run deploy:hosting # Deploy only hosting to FirebaseThis application uses a custom CORS proxy to bypass browser restrictions:
Browser → CORS Proxy → VirusTotal API ✅
The proxy is hosted at: https://cors-proxy.errcruze404.workers.dev/
The application is fully integrated with Firebase services:
- ✅ Hosting - Static site hosting
- ✅ Analytics - User analytics and tracking
- ⏳ Authentication - Ready for user authentication
- ⏳ Firestore - Ready for database features
- ⏳ Storage - Ready for file storage
cruze-scan/
├── src/
│ ├── firebase.ts # Firebase configuration
│ ├── utils/
│ │ └── api.ts # API utilities with CORS proxy
│ ├── pages/
│ │ ├── Terms.tsx # Terms of Service
│ │ └── Privacy.tsx # Privacy Policy
│ ├── App.tsx # Main application
│ ├── main.tsx # Entry point
│ └── index.css # Global styles
├── firebase.json # Firebase configuration
├── .firebaserc # Firebase project settings
└── package.json # Dependencies
Create a .env file (see .env.example):
VITE_VIRUSTOTAL_API_KEY=your-api-key-here
VITE_CORS_PROXY=https://cors-proxy.errcruze404.workers.dev/?url=# First time
npm install -g firebase-tools
firebase login
# Deploy
npm run deployThe app is a standard React SPA and can be deployed to:
- Vercel
- Netlify
- GitHub Pages
- Any static hosting service
Just run npm run build and deploy the dist folder.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Abhiyan P A
- GitHub: @abhiyanPA
- Website: scan.abhiyanpa.in
- VirusTotal - For the amazing threat intelligence API
- Firebase - For hosting and analytics
- React - For the awesome UI library
- Tailwind CSS - For the utility-first CSS framework
⭐ Star this repository if you find it helpful!
Created by Abhiyan P A