Skip to content

Commit 0f1e583

Browse files
momenbaselmomenbasel
committed
Add interactive tools, visual diagrams, and UI overhaul
- Interactive D3.js knowledge graph: 71 machines, 42 techniques, 5 certs with force-directed layout, filtering, search, and hover details - Machine Finder: searchable/filterable table with difficulty, OS, technique, and certification filters plus card view - Attack path diagrams: 27 Mermaid flowcharts showing full exploit chains from recon to root for top machines across all difficulties - Skill trees: 7 progression maps covering cert roadmap, OSCP prep, AD attacks, web exploitation, Linux/Windows privesc, and overall path - ProLab network topology diagrams: Mermaid diagrams for all 6 ProLabs showing subnets, pivot points, domain trusts, and attack flow - Custom CSS theme with HTB branding, stat cards, feature cards, improved tables, and responsive design - Social preview image (PNG + SVG) for link sharing - GitHub issue templates for writeup submissions and broken link reports - Discussions enabled for community engagement - Updated home page with interactive tools section and stats grid - Updated README with interactive tools table and site link
1 parent 92885fd commit 0f1e583

14 files changed

Lines changed: 3880 additions & 24 deletions

File tree

‎.github/ISSUE_TEMPLATE/broken-link.yml‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
name: Broken Link Report
2+
description: Report a broken or outdated writeup link
3+
title: "[Link] Broken link in ..."
4+
labels: ["broken-link"]
5+
body:
6+
- type: input
7+
id: page
8+
attributes:
9+
label: Page
10+
description: Which page has the broken link?
11+
placeholder: "machines/easy/README.md"
12+
validations:
13+
required: true
14+
- type: input
15+
id: broken-url
16+
attributes:
17+
label: Broken URL
18+
description: The URL that is broken
19+
validations:
20+
required: true
21+
- type: input
22+
id: replacement
23+
attributes:
24+
label: Suggested Replacement
25+
description: If you know a working alternative URL

‎.github/ISSUE_TEMPLATE/writeup-submission.yml‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
name: Writeup Submission
2+
description: Submit a writeup for an HTB machine or challenge
3+
title: "[Writeup] Machine/Challenge Name"
4+
labels: ["writeup-submission"]
5+
body:
6+
- type: dropdown
7+
id: type
8+
attributes:
9+
label: Content Type
10+
options:
11+
- Machine
12+
- Challenge
13+
- Sherlock
14+
- ProLab
15+
- CTF Event
16+
validations:
17+
required: true
18+
- type: input
19+
id: name
20+
attributes:
21+
label: Name
22+
description: Machine, challenge, or lab name
23+
placeholder: e.g., "Forest"
24+
validations:
25+
required: true
26+
- type: dropdown
27+
id: difficulty
28+
attributes:
29+
label: Difficulty
30+
options:
31+
- Easy
32+
- Medium
33+
- Hard
34+
- Insane
35+
validations:
36+
required: true
37+
- type: input
38+
id: url
39+
attributes:
40+
label: Writeup URL
41+
description: Link to your writeup (blog post, GitHub, etc.)
42+
placeholder: "https://yourblog.com/htb-forest"
43+
validations:
44+
required: true
45+
- type: textarea
46+
id: techniques
47+
attributes:
48+
label: Key Techniques
49+
description: What techniques does this writeup cover?
50+
placeholder: "AS-REP Roasting, DCSync, BloodHound"
51+
validations:
52+
required: true

‎README.md‎

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,19 @@
2020

2121
**Why this repo?** Unlike scattered blog posts and single-author collections, this is a **structured, searchable index** of the entire HTB ecosystem - machines from 2017 to 2026, every CTF event, every challenge category, every ProLab - cross-referenced by technique, difficulty, OS, and certification relevance. Whether you're preparing for **OSCP**, **CPTS**, **CRTO**, or just sharpening your skills, start here.
2222

23+
> **[Browse the site](https://momenbasel.github.io/htb-writeups/)** for the best experience - interactive tools, search, and dark theme.
24+
25+
---
26+
27+
## Interactive Tools
28+
29+
| | Tool | Description |
30+
|--|------|-------------|
31+
| **[Machine Finder](https://momenbasel.github.io/htb-writeups/finder/)** | Search & Filter | Find machines by difficulty, OS, technique, CVE, or certification. Table and card views with real-time filtering. |
32+
| **[Knowledge Graph](https://momenbasel.github.io/htb-writeups/graph/)** | Visual Explorer | Interactive D3.js force-directed graph mapping 70+ machines to 40+ techniques and 5 certifications. |
33+
| **[Attack Paths](https://momenbasel.github.io/htb-writeups/attack-paths/)** | Flowcharts | Mermaid diagrams showing complete attack chains for 25+ machines - from recon to root. |
34+
| **[Skill Trees](https://momenbasel.github.io/htb-writeups/skill-trees/)** | Progression Maps | Visual learning paths for AD attacks, web exploitation, Linux/Windows privesc, and cert preparation. |
35+
2336
---
2437

2538
## What's Inside
@@ -28,9 +41,9 @@
2841
|---------|-------------|-------|
2942
| [Machines](#machines) | Boot2root walkthroughs (Easy to Insane) | 300+ |
3043
| [Challenges](#challenges) | CTF-style challenges across 12 categories | 400+ |
31-
| [ProLabs](#prolabs) | Enterprise-grade lab walkthroughs | 6 |
32-
| [Sherlocks](#sherlocks) | DFIR & Blue Team investigations | 38+ |
33-
| [CTF Events](#ctf-events) | Official HTB CTF competition writeups | 6 events |
44+
| [ProLabs](#prolabs) | Enterprise-grade lab walkthroughs with network topology diagrams | 6 |
45+
| [Sherlocks](#sherlocks) | DFIR & Blue Team investigations | 70+ |
46+
| [CTF Events](#ctf-events) | Official HTB CTF competition writeups | 14 events |
3447
| [Endgames](#endgames) | Multi-machine scenario walkthroughs | 5 |
3548
| [Fortresses](#fortresses) | Multi-flag single-host challenges | 6 |
3649
| [Resources](#resources) | Tools, cheatsheets, cert prep, methodology | 10 guides |

‎_config.yml‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,19 @@ search.button: true
2020

2121
heading_anchors: true
2222

23+
mermaid:
24+
version: "10.9.0"
25+
2326
plugins:
2427
- jekyll-include-cache
2528

2629
aux_links:
2730
"GitHub":
2831
- "https://github.com/momenbasel/htb-writeups"
32+
"Machine Finder":
33+
- "https://momenbasel.github.io/htb-writeups/finder/"
34+
"Knowledge Graph":
35+
- "https://momenbasel.github.io/htb-writeups/graph/"
2936

3037
aux_links_new_tab: true
3138

@@ -36,6 +43,10 @@ back_to_top_text: "Back to top"
3643

3744
footer_content: 'Copyright &copy; 2026 <a href="https://github.com/momenbasel">Moamen Basel</a>. Distributed under the <a href="https://github.com/momenbasel/htb-writeups/blob/main/LICENSE">MIT License</a>.'
3845

46+
# Custom head content for extra CSS
47+
head_extra: |
48+
<link rel="stylesheet" href="/htb-writeups/assets/css/custom.css">
49+
3950
callouts:
4051
warning:
4152
title: Warning

‎_includes/head_custom.html‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
<link rel="stylesheet" href="{{ '/assets/css/custom.css' | relative_url }}">
2+
<meta property="og:image" content="{{ '/assets/images/social-preview.svg' | absolute_url }}">
3+
<meta property="og:title" content="HTB Writeups - The Ultimate Hack The Box Resource">
4+
<meta property="og:description" content="500+ machines, 400+ challenges, ProLabs, Sherlocks, skill trees, attack paths, and certification prep. Interactive knowledge graph and machine finder.">
5+
<meta name="twitter:card" content="summary_large_image">
6+
<meta name="twitter:image" content="{{ '/assets/images/social-preview.svg' | absolute_url }}">

0 commit comments

Comments
 (0)