CyberSuite

Your Complete Cybersecurity Suite for Passwords, Files, Scanning, and Security Training

Protecting digital life with AES-256 encryption, password management, network scanning, file vaulting, and hands-on security education.

---

Index

• Screenshots
• Executive Snapshot
• Why CyberSuite Stands Out
• Core Modules
• Tech Stack
• Security Architecture
• Installation
• Project Structure
• API Endpoints
• Testing
• Contributing
• License
• Author

---

Screenshots

Dashboard

Light Mode	Dark Mode

Password Manager

Password Vault	Add Credential

Dark Vault	ML Password Analysis

Security Tools

Two-Factor Authentication	Network Scanner

File Vault	Profile & Settings

Education and Data

Learning Hub	Database View

---

🚀 Executive Snapshot

CyberSuite is a full-stack cybersecurity platform built to showcase practical security engineering in one product. It combines encrypted credential storage, protected file handling, live network scanning, two-factor authentication, ML-assisted threat analysis, and guided security education into a single polished experience.

This README is designed to make the value obvious quickly for managers, recruiters, and technical reviewers: the product looks professional, the security story is clear, and the implementation spans frontend, backend, and ML services.

📌 Snapshot: One platform, multiple security layers, and a polished product story that signals real engineering depth fast.

Highlights at a glance

Security First AES-256-GCM, 2FA, HttpOnly cookies, and validation-driven flows.

Real Features Password vault, network scanner, file vault, and ML support.

Presentation Ready A polished product story designed to win fast attention.

Capability	Value
Password Security	AES-256-GCM encrypted credential vault with search, filtering, and strength analysis
Network Scanning	TCP-based scanning for common ports and security exposure checks
File Protection	Encrypted upload and secure download flow for sensitive files
Security Training	Course-based education module with progress tracking
ML Intelligence	Login anomaly detection and password analysis support

---

✨ Why CyberSuite Stands Out

CyberSuite is more than a demo app. It presents a coherent security platform with a strong visual identity and a practical feature set that maps directly to real-world concerns.

What a recruiter sees	Why it matters
Clear product vision	It reads like a finished platform, not a classroom exercise
Real engineering depth	Security, backend, frontend, and ML all show up in one system
Strong product polish	The first screen communicates confidence and momentum

🎯 Clear product vision

It reads like a finished platform, not a classroom exercise.

🧠 Real engineering depth

Security, backend, frontend, and ML all show up in one system.

🪄 Strong product polish

The first screen communicates confidence and momentum.

• Zero-knowledge style password storage with authenticated encryption
• Real network scanning instead of placeholder UI
• Secure file vault behavior with client-side protection flow
• 2FA support and security settings surfaced in the user experience
• Educational content to demonstrate product thinking beyond raw tooling
• A polished landing page that communicates value fast

---

🧩 Core Modules

🔐 Password Manager Encrypted credential storage with generation, analysis, and retrieval.	🕵️ Network Scanner Authorized TCP scanning with exposure hints and readable results.
📦 File Vault Encrypted upload and download handling for sensitive documents.	🎓 Security Education Course-based learning with progress tracking and practical guidance.
🛡️ Two-Factor Authentication TOTP verification, QR setup, and backup recovery codes.	🤖 ML Security Intelligence Anomaly detection and password analysis through a dedicated service.

Password Manager

• AES-256-GCM credential encryption
• Password generation and strength analysis
• Search, filtering, and category organization
• Secure storage and retrieval flows

Network Scanner

• TCP port scanning for common service ports
• Hostname and IP-based scanning support
• Vulnerability and exposure hints for insecure services
• Console-style and dashboard-style scanning views

File Vault

• Encrypted file upload and download flow
• Metadata tracking and access control
• Secure handling for sensitive documents

Security Education

• Course-based learning experience
• Progress tracking across lessons
• Content aimed at security awareness and best practices

Two-Factor Authentication

• TOTP-based verification flow
• QR code setup for authenticator apps
• Backup code support for recovery

ML Security Intelligence

• Login anomaly detection support
• Password analysis enhancements
• Separate Python microservice for ML workloads

---

🛠️ Tech Stack

🧱 Frontend Next.js 15, React 19, TypeScript, Tailwind CSS, shadcn/ui

⚙️ Backend Node.js, Express, MongoDB, Mongoose, JWT, bcryptjs, Multer

🧪 ML Service Python 3.x, Flask, scikit-learn, pandas, numpy, joblib

Frontend

• Next.js 15
• React 19
• TypeScript
• Tailwind CSS
• shadcn/ui

Backend

• Node.js
• Express.js
• MongoDB
• Mongoose
• JWT
• bcryptjs
• Multer
• Speakeasy
• Nodemailer

ML Service

• Python 3.x
• Flask
• scikit-learn
• pandas
• numpy
• joblib

---

🔒 Security Architecture

CyberSuite is built around defense-in-depth.

🛡️ Defense in depth: the platform treats identity, data, and operational safety as separate concerns, not one blended control.

🪪 Identity & Session JWT, HttpOnly cookies, SameSite enforcement, and 2FA.	🧷 Data Protection AES-256-GCM, secure file handling, and encrypted credential flows.
🧱 App Hardening Helmet, rate limiting, validation, and size limits.	⚡ Operational Safety Dedicated ML service and controlled password reset flows.

• Authenticated encryption for sensitive credential and file workflows
• HttpOnly cookie-based session handling
• CSRF-aware cookie configuration
• Input validation on user-facing endpoints
• Rate limiting and security headers
• Password reset flow with time-limited tokens
• Separate ML service for isolated processing

---

🧰 Installation

Step 1	Step 2	Step 3
Clone	Configure	Run

🧭 Setup flow: clone the repo, wire the environment variables, then start the backend, frontend, and optional ML service.

Prerequisites

• Node.js 18 or later
• MongoDB 6 or later
• Python 3.8 or later for ML features
• npm or pnpm

Clone the repository

git clone https://github.com/Git-brintsi20/CyberSuite.git
cd CyberSuite/cybersecurity-suite

Backend setup

cd server
npm install

Create server/.env:

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret_key
ENCRYPTION_KEY=your_64_character_hex_key
PORT=5000
NODE_ENV=development
FRONTEND_URL=http://localhost:3000
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email@gmail.com
SMTP_PASSWORD=your_app_password
EMAIL_FROM=CyberSuite <your_email@gmail.com>
ML_SERVICE_URL=http://localhost:5001

Frontend setup

cd ../client
npm install

Create client/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:5000

Optional ML service setup

cd ../server/ml_service
pip install -r requirements.txt

Run locally

Backend:

cd server
npm start

Frontend:

cd client
npm run dev

ML service:

cd server/ml_service
python app.py

---

🗂️ Project Structure

The structure is intentionally split between a modern frontend, a secure API layer, and an isolated ML service.

cybersecurity-suite/
├── client/                 # Next.js frontend application
│   ├── app/                # App Router pages
│   ├── components/        # UI and feature components
│   ├── contexts/          # React context providers
│   ├── hooks/             # Custom hooks
│   └── lib/               # Utilities and API helpers
└── server/                # Express backend and services
    ├── controllers/       # Request handlers
    ├── middleware/        # Auth and logging middleware
    ├── models/            # MongoDB models
    ├── routes/            # API routes
    ├── utils/             # Encryption and helper utilities
    └── ml_service/        # Python ML microservice

---

🌐 API Endpoints

The API surface is organized around the product’s major workflows so the architecture stays easy to understand.

Authentication

• POST /api/auth/register
• POST /api/auth/login
• POST /api/auth/login/2fa
• POST /api/auth/logout
• GET /api/auth/me

Password Management

• GET /api/passwords
• POST /api/passwords
• PUT /api/passwords/:id
• DELETE /api/passwords/:id
• POST /api/passwords/:id/decrypt

Two-Factor Authentication

• POST /api/2fa/setup
• POST /api/2fa/verify
• POST /api/2fa/validate
• POST /api/2fa/disable
• GET /api/2fa/status

File Vault

• GET /api/files
• POST /api/files/upload
• GET /api/files/:id/download
• DELETE /api/files/:id

ML Service

• GET /api/ml/health
• POST /api/ml/analyze-password
• POST /api/ml/detect-anomaly
• POST /api/ml/train

Education

• GET /api/education/courses
• GET /api/education/courses/:id
• POST /api/education/progress

---

🧪 Testing

Use the application locally and verify the main flows:

01	Open the app and confirm the landing page loads cleanly.
02	Create an account or log in and verify authentication.
03	Exercise the password manager, file vault, scanner, and education flows.

1. Open http://localhost:3000
2. Register or log in
3. Test the password manager and file vault
4. Run a scan in the network scanner
5. Review the education module and profile settings

---

🤝 Contributing

Contributions are welcome. Please keep changes focused, secure, and consistent with the current architecture.

Fork	Branch	Commit	Pull Request

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a pull request

---

License

This project is licensed under the MIT License. See LICENSE for details.

---

Author

Git-brintsi20

• GitHub: @Git-brintsi20
• Repository: CyberSuite

---

If this project helps, star it and share the demo.

Made with care for a more secure digital world.

💡 Contribution goal: small, high-signal changes that improve the user experience, strengthen security, or sharpen the product narrative.