Building 70 Projects ranging from beginner to advanced so anyone can β learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company π
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
Update CONTRIBUTING.md and submodule workflow for new structure
CarterPerez-dev69212e5e8d6f
diff --git a/.github/workflows/update-submodule.yml b/.github/workflows/update-submodule.ymlindex 992d32cf..cbfde2d4 100644--- a/.github/workflows/update-submodule.yml+++ b/.github/workflows/update-submodule.yml@@ -23,7 +23,7 @@ jobs:- name: Update submodule to latestrun: |- git submodule update --remote templates/fullstack-template+ git submodule update --remote TEMPLATES/fullstack-template- name: Check for changesid: changesdiff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex b2814024..2c01d85b 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -21,7 +21,7 @@ cd Cybersecurity-Projects### 2. Create Your Project Directory-Create a new directory in `/PROJECTS` with a descriptive, lowercase, hyphenated name.+Create a new directory in `/PROJECTS/{difficulty}` where difficulty is `beginner`, `intermediate`, or `advanced`. Use a descriptive, lowercase, hyphenated name for your project.**Naming Convention:**- β `reverse-shell-handler`@@ -33,14 +33,19 @@ Create a new directory in `/PROJECTS` with a descriptive, lowercase, hyphenated- β `ReverseShellHandler` (no PascalCase)- β `Reverse-Shell-Handler` (no capital letters)+**Difficulty Levels:**+- **Beginner:** Basic tools, single-file scripts, foundational concepts+- **Intermediate:** Multi-component systems, API integrations, moderate complexity+- **Advanced:** Full-stack applications, distributed systems, complex architectures+**Examples:**-| Project Name | Directory Name |-|-------------|----------------|-| Reverse Shell Handler | `reverse-shell-handler` |-| SIEM Dashboard | `siem-dashboard` |-| OAuth Token Analyzer | `oauth-token-analyzer` |-| AI Threat Detection | `ai-threat-detection` |+| Project Name | Difficulty | Directory Path |+|-------------|------------|----------------|+| Simple Port Scanner | Beginner | `PROJECTS/beginner/simple-port-scanner` |+| OAuth Token Analyzer | Intermediate | `PROJECTS/intermediate/oauth-token-analyzer` |+| Bug Bounty Platform | Advanced | `PROJECTS/advanced/bug-bounty-platform` |+| API Security Scanner | Intermediate | `PROJECTS/intermediate/api-security-scanner` |### 3. Project Structure@@ -62,17 +67,29 @@ Ensure your project structure is coherent and uses **intuitive, idiomatic naming**Example Structure:**```PROJECTS/-βββ your-project-name/- βββ README.md- βββ .env.example- βββ requirements.txt- βββ docker-compose.yml- βββ src/- β βββ __init__.py- β βββ main.py- β βββ utils/- βββ tests/- βββ examples/+βββ beginner/+β βββ simple-port-scanner/+β βββ README.md+β βββ src/+βββ intermediate/+β βββ oauth-token-analyzer/+β βββ README.md+β βββ .env.example+β βββ requirements.txt+β βββ src/+β β βββ __init__.py+β β βββ main.py+β β βββ utils/+β βββ tests/+βββ advanced/+ βββ bug-bounty-platform/+ βββ README.md+ βββ .env.example+ βββ docker-compose.yml+ βββ backend/+ βββ frontend/+ βββ tests/+ βββ examples/```### 4. Package Managers if using Python and or Node (Doesn't matter what you use for any other framework/libary/language though)@@ -133,7 +150,7 @@ Format your code using the repository's custom YAPF configuration. Copy the [.styapf -i -r -vv your_project/```-Don't have YAPF installed?+Don't have YAPF installed?```bash# With uv (you're using uv, right?)uv pip install yapf@@ -154,9 +171,9 @@ More info: [YAPF Documentation](https://github.com/google/yapf)### 7. Full-Stack Projects-Building a full-stack application? Consider using this template as a starting point:+Building a full-stack application? Use the included template as a starting point:-**[Fullstack Template](https://github.com/CarterPerez-dev/fullstack-template)** - A production-ready template with FastAPI, React, Docker, and more.+**[Fullstack Template](./TEMPLATES/fullstack-template)** - A production-ready template with FastAPI, React, Docker, and more. Check the [GitHub repository](https://github.com/CarterPerez-dev/fullstack-template) for the latest updates.### 8. Submit a Pull Requestdiff --git a/README.md b/README.mdindex 4063dff1..b6639a1f 100644--- a/README.md+++ b/README.md@@ -23,7 +23,7 @@<h2 align="center"><strong>View Complete Projects:</strong></h2><div align="center"><a href="https://github.com/CarterPerez-dev/Cybersecurity-Projects/tree/main/PROJECTS">- <img src="https://img.shields.io/badge/Full_Source_Code-10/60-blue?style=for-the-badge&logo=github" alt="Projects"/>+ <img src="https://img.shields.io/badge/Full_Source_Code-11/60-blue?style=for-the-badge&logo=github" alt="Projects"/></a></div>@@ -42,12 +42,6 @@ Tools, courses, certifications, communities, and frameworks for cybersecurity pr----Big thanks to the current contributors!-- [@deniskhud](https://github.com/deniskhud): [Simple Port Scanner](./PROJECTS/beginner/simple-port-scanner)-- [@Heritage-XioN](https://github.com/Heritage-XioN): [Metadata Scrubber Tool](./PROJECTS/beginner/metadata-scrubber-tool)------# Projects### Beginner Projects@@ -56,7 +50,7 @@ Big thanks to the current contributors!- **[Keylogger](./PROJECTS/beginner/keylogger)** - Capture keyboard events with timestamps using Python pynput- **[Caesar Cipher](./PROJECTS/beginner/caesar-cipher)** - CLI encryption/decryption tool with brute-force capabilities- **[DNS Lookup CLI Tool](./PROJECTS/beginner/dns-lookup)** - Query DNS records with WHOIS and reverse lookup-- **[Simple Vulnerability Scanner](./SYNOPSES/beginner/Simple.Vulnerability.Scanner.md)** - Check software versions against CVE databases+- **[Simple Vulnerability Scanner](./PROJECTS/beginner/simple-vulnerability-scanner)** - Check software versions against CVE databases- **[Metadata Scrubber Tool](./PROJECTS/beginner/metadata-scrubber-tool)** - Remove EXIF and privacy-sensitive metadata from files- **[Network Traffic Analyzer](./SYNOPSES/beginner/Network.Traffic.Analyzer.md)** - Capture and analyze network packets with scapy- **[Hash Cracker](./SYNOPSES/beginner/Hash.Cracker.md)** - Dictionary and brute-force hash cracking tool