docs: add Mintlify docs.json + MDX homepage (#712)
Co-authored-by: Clawdbot <clawdbot@Clawdbots-Mac-mini.local>
taylorcopilot committed
Feb 14, 2026 at 22:10 UTC
626809e67ae60773f760722ed72a2e1a5df79dad
3 files changed
+254
-23
docs.json
deleted
-23
@@ -1,23 +0,0 @@
1
-{
2
- "$schema": "https://mintlify.com/docs.json",
3
- "theme": "mint",
4
- "name": "Documentation",
5
- "colors": {
6
- "primary": "#0D9373"
7
- },
8
- "navigation": {
9
- "tabs": [
10
- {
11
- "tab": "Untitled Tab",
12
- "groups": [
13
- {
14
- "group": "Getting Started",
15
- "pages": [
16
- "test"
17
- ]
18
- }
19
- ]
20
- }
21
- ]
22
- }
23
-}
\ No newline at end of file
docs/docs.json
new
+179
@@ -0,0 +1,179 @@
1
+{
2
+ "$schema": "https://mintlify.com/docs.json",
3
+ "theme": "mint",
4
+ "name": "SOCFortress CoPilot",
5
+ "description": "SOCFortress CoPilot documentation — operator workflows, admin/engineer configuration, and developer/AI-agent guides.",
6
+ "logo": {
7
+ "light": "/assets/brand/logo-text.png",
8
+ "dark": "/assets/brand/logo-text.png",
9
+ "href": "/"
10
+ },
11
+ "favicon": "/assets/brand/favicon.ico",
12
+ "colors": {
13
+ "primary": "#f85d3b",
14
+ "dark": "#f85d3b",
15
+ "light": "#f85d3b"
16
+ },
17
+ "navigation": {
18
+ "tabs": [
19
+ {
20
+ "tab": "User Guide",
21
+ "groups": [
22
+ {
23
+ "group": "Start here",
24
+ "pages": [
25
+ "index",
26
+ "user/overview",
27
+ "user/navigation",
28
+ "user/features"
29
+ ]
30
+ },
31
+ {
32
+ "group": "Quickstarts",
33
+ "pages": [
34
+ "user/operators-quickstart",
35
+ "user/admins-quickstart"
36
+ ]
37
+ },
38
+ {
39
+ "group": "Provisioning",
40
+ "pages": [
41
+ "user/customer-provisioning"
42
+ ]
43
+ },
44
+ {
45
+ "group": "Videos",
46
+ "pages": [
47
+ "user/videos"
48
+ ]
49
+ }
50
+ ]
51
+ },
52
+ {
53
+ "tab": "UI Guide",
54
+ "groups": [
55
+ {
56
+ "group": "Overview",
57
+ "pages": [
58
+ "user/ui/overview"
59
+ ]
60
+ },
61
+ {
62
+ "group": "Incident Management",
63
+ "pages": [
64
+ "user/ui/incident-management",
65
+ "user/ui/incident-alerts",
66
+ "user/ui/incident-cases",
67
+ "user/ui/incident-sources"
68
+ ]
69
+ },
70
+ {
71
+ "group": "Customers",
72
+ "pages": [
73
+ "user/ui/customers",
74
+ "user/ui/external-third-party-integrations",
75
+ "user/ui/external-network-connectors"
76
+ ]
77
+ },
78
+ {
79
+ "group": "Graylog",
80
+ "pages": [
81
+ "user/ui/graylog",
82
+ "user/ui/graylog-management",
83
+ "user/ui/graylog-pipelines",
84
+ "user/ui/graylog-metrics"
85
+ ]
86
+ },
87
+ {
88
+ "group": "Indices",
89
+ "pages": [
90
+ "user/ui/indices",
91
+ "user/ui/indices-management",
92
+ "user/ui/indices-snapshots"
93
+ ]
94
+ },
95
+ {
96
+ "group": "Agents",
97
+ "pages": [
98
+ "user/ui/agents",
99
+ "user/ui/agents-groups",
100
+ "user/ui/agents-vulnerability-overview",
101
+ "user/ui/agents-sca-overview",
102
+ "user/ui/agents-sysmon-config",
103
+ "user/ui/agents-patch-tuesday",
104
+ "user/ui/agents-detection-rules",
105
+ "user/ui/agents-copilot-actions"
106
+ ]
107
+ },
108
+ {
109
+ "group": "Reports",
110
+ "pages": [
111
+ "user/ui/report-general",
112
+ "user/ui/report-creation",
113
+ "user/ui/report-sca",
114
+ "user/ui/report-vulnerability"
115
+ ]
116
+ },
117
+ {
118
+ "group": "Other",
119
+ "pages": [
120
+ "user/ui/healthcheck",
121
+ "user/ui/scheduler",
122
+ "user/ui/artifacts",
123
+ "user/ui/customer-portal"
124
+ ]
125
+ }
126
+ ]
127
+ },
128
+ {
129
+ "tab": "Developer",
130
+ "groups": [
131
+ {
132
+ "group": "Start here",
133
+ "pages": [
134
+ "developer/start-here"
135
+ ]
136
+ },
137
+ {
138
+ "group": "Architecture",
139
+ "pages": [
140
+ "architecture/ARCHITECTURE",
141
+ "architecture/MAP",
142
+ "architecture/DEPLOYMENT",
143
+ "architecture/DATA_FLOWS",
144
+ "architecture/DATABASE_SCHEMA"
145
+ ]
146
+ },
147
+ {
148
+ "group": "Integrations",
149
+ "pages": [
150
+ "integrations/ADDING_A_CONNECTOR"
151
+ ]
152
+ }
153
+ ]
154
+ },
155
+ {
156
+ "tab": "GitHub",
157
+ "groups": [
158
+ {
159
+ "group": "Project",
160
+ "pages": [
161
+ {
162
+ "title": "CoPilot repo",
163
+ "href": "https://github.com/socfortress/CoPilot"
164
+ },
165
+ {
166
+ "title": "Releases",
167
+ "href": "https://github.com/socfortress/CoPilot/releases"
168
+ },
169
+ {
170
+ "title": "Issues",
171
+ "href": "https://github.com/socfortress/CoPilot/issues"
172
+ }
173
+ ]
174
+ }
175
+ ]
176
+ }
177
+ ]
178
+ }
179
+}
docs/index.mdx
new
+75
@@ -0,0 +1,75 @@
1
+---
2
+title: SOCFortress CoPilot
3
+description: Operate an open-source SOC/SIEM stack from a single pane of glass.
4
+---
5
+
6
+# SOCFortress CoPilot Documentation
7
+
8
+<Columns cols={2}>
9
+ <div>
10
+
11
+CoPilot is a **single pane of glass** for operating an open‑source SOC/SIEM stack (Wazuh, Graylog, Velociraptor, Grafana, Shuffle, and more).
12
+
13
+**Choose your path:**
14
+
15
+<Card title="SOC Operator / Analyst" icon="siren" href="/user/operators-quickstart" horizontal>
16
+ Alert triage → cases → investigations.
17
+</Card>
18
+
19
+<Card title="Admin / Engineer" icon="gear" href="/user/admins-quickstart" horizontal>
20
+ Configure sources, connectors, and integrations.
21
+</Card>
22
+
23
+<Card title="Developer / AI Agent" icon="code" href="/developer/start-here" horizontal>
24
+ Architecture, data flows, schema, and safe change playbooks.
25
+</Card>
26
+
27
+ </div>
28
+
29
+ <Frame>
30
+ <video autoplay loop muted playsInline style={{width: '100%', borderRadius: 16}}>
31
+ <source src="/assets/hero/copilot-hub.webm" type="video/webm" />
32
+ <source src="/assets/hero/copilot-hub.mp4" type="video/mp4" />
33
+ </video>
34
+ </Frame>
35
+</Columns>
36
+
37
+## Popular tasks
38
+
39
+<Columns cols={3}>
40
+ <Card title="Provision a customer" icon="users" href="/user/customer-provisioning">
41
+ Create a tenant and set up the minimum required configuration.
42
+ </Card>
43
+ <Card title="Add integrations & connectors" icon="plug" href="/user/ui/external-third-party-integrations">
44
+ Connect third‑party sources and external network connectors.
45
+ </Card>
46
+ <Card title="Triage an alert → open a case" icon="triangle-exclamation" href="/user/ui/incident-alerts">
47
+ Start from an alert and manage work in a case.
48
+ </Card>
49
+</Columns>
50
+
51
+<Columns cols={3}>
52
+ <Card title="Manage indices" icon="database" href="/user/ui/indices-management">
53
+ Validate index patterns, retention, and troubleshooting.
54
+ </Card>
55
+ <Card title="Browse the UI Guide" icon="map" href="/user/ui/overview">
56
+ Documentation that mirrors the CoPilot menu.
57
+ </Card>
58
+ <Card title="Video library (summarized)" icon="play" href="/user/videos">
59
+ Watch the playlist like docs: links + structured bullets (no transcripts stored).
60
+ </Card>
61
+</Columns>
62
+
63
+## Get oriented
64
+
65
+<Steps>
66
+ <Step title="Start with a quickstart">
67
+ Operators: start with the [Operator quickstart](/user/operators-quickstart). Admins/engineers: start with the [Admin/Engineer quickstart](/user/admins-quickstart).
68
+ </Step>
69
+ <Step title="Use the UI Guide for day-to-day workflows">
70
+ The [UI Guide](/user/ui/overview) mirrors the menu so people can find what they see in the product.
71
+ </Step>
72
+ <Step title="Use videos as supplemental walkthroughs">
73
+ The [Videos page](/user/videos) summarizes the full playlist into skimmable sections.
74
+ </Step>
75
+</Steps>