docs: adopt DFIR-IRIS-style landing layout and branding (#698)
Co-authored-by: Clawdbot <clawdbot@Clawdbots-Mac-mini.local>
taylorcopilot committed
Feb 14, 2026 at 11:18 UTC
54a2cb5f6dc6ecfc74f9aad9d42425285065acde
6 files changed
+90
-11
docs/assets/brand/favicon.ico
Binary files /dev/null and b/docs/assets/brand/favicon.ico differ
docs/assets/brand/logo-text.png
Binary files /dev/null and b/docs/assets/brand/logo-text.png differ
docs/assets/brand/logo.png
Binary files /dev/null and b/docs/assets/brand/logo.png differ
docs/index.md
+45
-6
@@ -1,15 +1,54 @@
1
# SOCFortress CoPilot Documentation
2
3
-CoPilot is a **single pane of glass** for operating an open‑source SOC/SIEM stack (Wazuh, Graylog, Velociraptor, Grafana, etc.).
3
+CoPilot is a **single pane of glass** for operating an open‑source SOC/SIEM stack (Wazuh, Graylog, Velociraptor, Grafana, Shuffle, etc.).
4
5
-This documentation is organized into two tracks:
5
+<div class="sf-home-grid" markdown>
6
7
-- **User Guide** (operators + admins/engineers)
8
-- **Developer / AI Agent Docs** (architecture + safe change playbooks)
7
+<div class="sf-card" markdown>
8
+
9
+## New to CoPilot?
10
+
11
+Start with the guides and get a working SOC workflow quickly.
12
+
13
+[Getting started →](user/operators-quickstart.md){ .md-button .md-button--primary }
14
+
15
+</div>
16
+
17
+<div class="sf-card" markdown>
18
+
19
+## Configure your stack
20
+
21
+Admins/engineers: set up connectors + integrations so alerts flow.
22
+
23
+[Admin quickstart →](user/admins-quickstart.md){ .md-button .md-button--primary }
24
+
25
+</div>
26
+
27
+<div class="sf-card" markdown>
28
+
29
+## Developer / AI Agent Docs
30
+
31
+Architecture, data flows, schema, and safe change playbooks.
32
+
33
+[Start here →](developer/start-here.md){ .md-button }
34
+
35
+</div>
36
+
37
+<div class="sf-card" markdown>
38
+
39
+## Video library (summarized)
40
+
41
+Use the playlist like documentation: grouped summaries by topic.
42
+
43
+[Browse videos →](user/videos.md){ .md-button }
44
+
45
+</div>
46
+
47
+</div>
48
49
---
50
12
-## Start here (pick your path)
51
+## Pick your path
52
53
=== "SOC operator / analyst"
54
@@ -42,4 +81,4 @@ This documentation is organized into two tracks:
81
82
- Use the **left sidebar** (hamburger menu on mobile) to navigate.
83
- Use **Search** (top bar) to jump straight to a topic.
45
-- Every page is stored in‑repo under `docs/` so it can be updated via PRs.
84
+- Everything lives under `docs/` and is updated via PRs.
docs/stylesheets/extra.css
+28
-2
@@ -1,8 +1,8 @@
1
-/* Small tweaks to make the landing page + nav feel less cramped */
1
+/* Small tweaks to make the docs feel more like a product site + guide */
2
3
/* Slightly wider content for guide-style docs */
4
.md-content__inner {
5
- max-width: 900px;
5
+ max-width: 980px;
6
}
7
8
/* Make inline code a touch more readable */
@@ -20,3 +20,29 @@
20
.md-typeset hr {
21
border-bottom: 1px solid var(--md-default-fg-color--lightest);
22
}
23
+
24
+/* Home page cards (DFIR-IRIS-ish layout) */
25
+.sf-home-grid {
26
+ display: grid;
27
+ grid-template-columns: repeat(12, 1fr);
28
+ gap: 1rem;
29
+ margin: 1.25rem 0 0.5rem;
30
+}
31
+
32
+.sf-card {
33
+ grid-column: span 12;
34
+ border: 1px solid rgba(255, 255, 255, 0.08);
35
+ background: rgba(255, 255, 255, 0.02);
36
+ border-radius: 14px;
37
+ padding: 1.1rem 1.1rem 0.8rem;
38
+}
39
+
40
+.sf-card h2 {
41
+ margin-top: 0.1rem;
42
+}
43
+
44
+@media (min-width: 900px) {
45
+ .sf-card {
46
+ grid-column: span 6;
47
+ }
48
+}
mkdocs.yml
+17
-3
@@ -4,12 +4,17 @@ site_url: https://socfortress.github.io/CoPilot/
4
repo_url: https://github.com/socfortress/CoPilot
5
edit_uri: edit/main/
6
7
+# Optional: show a link to the repo in the header like many MkDocs sites
8
+repo_name: socfortress/CoPilot
9
+
10
# Use pretty URLs (/user/overview/) instead of .html pages.
11
use_directory_urls: true
12
13
theme:
14
name: material
15
language: en
16
+ logo: assets/brand/logo.png
17
+ favicon: assets/brand/favicon.ico
18
font:
19
text: IBM Plex Sans
20
code: JetBrains Mono
@@ -34,6 +39,18 @@ theme:
39
plugins:
40
- search
41
42
+extra:
43
+ generator: false
44
+ social:
45
+ - icon: fontawesome/brands/github
46
+ link: https://github.com/socfortress/CoPilot
47
+ - icon: fontawesome/brands/youtube
48
+ link: https://www.youtube.com/@taylorwalton_socfortress
49
+ - icon: fontawesome/brands/medium
50
+ link: https://socfortress.medium.com/
51
+ - icon: fontawesome/brands/linkedin
52
+ link: https://www.linkedin.com/company/socfortressmdr/
53
+
54
markdown_extensions:
55
- admonition
56
- attr_list
@@ -48,9 +65,6 @@ markdown_extensions:
65
- def_list
66
- footnotes
67
51
-extra:
52
- generator: false
53
-
68
extra_css:
69
- stylesheets/socfortress-theme.css
70
- stylesheets/extra.css