From f8558b6c6a79f70467b70127086ee7a515918102 Mon Sep 17 00:00:00 2001
From: Anish Sarkar <104695310+AnishSarkar22@users.noreply.github.com>
Date: Thu, 12 Mar 2026 21:11:39 +0530
Subject: [PATCH] feat: add new index sections for Connectors, Docker
 Installation, and How-To Guides

---
 .../content/docs/connectors/index.mdx         | 101 ++++++++++++++++++
 .../docs/docker-installation/index.mdx        |  36 +++++++
 surfsense_web/content/docs/how-to/index.mdx   |  21 ++++
 3 files changed, 158 insertions(+)
 create mode 100644 surfsense_web/content/docs/connectors/index.mdx
 create mode 100644 surfsense_web/content/docs/docker-installation/index.mdx
 create mode 100644 surfsense_web/content/docs/how-to/index.mdx

diff --git a/surfsense_web/content/docs/connectors/index.mdx b/surfsense_web/content/docs/connectors/index.mdx
new file mode 100644
index 000000000..501b1fc0b
--- /dev/null
+++ b/surfsense_web/content/docs/connectors/index.mdx
@@ -0,0 +1,101 @@
+---
+title: Connectors
+description: Integrate with third-party services
+---
+
+import { Card, Cards } from 'fumadocs-ui/components/card';
+
+Connect SurfSense to your favorite tools and services. Browse the available integrations below to sync data from productivity apps, communication platforms, knowledge bases, and more.
+
+<Cards>
+  <Card
+    title="Google Drive"
+    description="Connect your Google Drive to SurfSense"
+    href="/docs/connectors/google-drive"
+  />
+  <Card
+    title="Gmail"
+    description="Connect your Gmail to SurfSense"
+    href="/docs/connectors/gmail"
+  />
+  <Card
+    title="Google Calendar"
+    description="Connect your Google Calendar to SurfSense"
+    href="/docs/connectors/google-calendar"
+  />
+  <Card
+    title="Notion"
+    description="Connect your Notion workspaces to SurfSense"
+    href="/docs/connectors/notion"
+  />
+  <Card
+    title="Slack"
+    description="Connect your Slack workspace to SurfSense"
+    href="/docs/connectors/slack"
+  />
+  <Card
+    title="Discord"
+    description="Connect your Discord servers to SurfSense"
+    href="/docs/connectors/discord"
+  />
+  <Card
+    title="Jira"
+    description="Connect your Jira projects to SurfSense"
+    href="/docs/connectors/jira"
+  />
+  <Card
+    title="Linear"
+    description="Connect your Linear workspace to SurfSense"
+    href="/docs/connectors/linear"
+  />
+  <Card
+    title="Microsoft Teams"
+    description="Connect your Microsoft Teams to SurfSense"
+    href="/docs/connectors/microsoft-teams"
+  />
+  <Card
+    title="Confluence"
+    description="Connect your Confluence spaces to SurfSense"
+    href="/docs/connectors/confluence"
+  />
+  <Card
+    title="Airtable"
+    description="Connect your Airtable bases to SurfSense"
+    href="/docs/connectors/airtable"
+  />
+  <Card
+    title="ClickUp"
+    description="Connect your ClickUp workspace to SurfSense"
+    href="/docs/connectors/clickup"
+  />
+  <Card
+    title="GitHub"
+    description="Connect your GitHub repositories to SurfSense"
+    href="/docs/connectors/github"
+  />
+  <Card
+    title="Luma"
+    description="Connect your Luma events to SurfSense"
+    href="/docs/connectors/luma"
+  />
+  <Card
+    title="Circleback"
+    description="Connect your Circleback meetings to SurfSense"
+    href="/docs/connectors/circleback"
+  />
+  <Card
+    title="Elasticsearch"
+    description="Connect your Elasticsearch cluster to SurfSense"
+    href="/docs/connectors/elasticsearch"
+  />
+  <Card
+    title="Bookstack"
+    description="Connect your Bookstack instance to SurfSense"
+    href="/docs/connectors/bookstack"
+  />
+  <Card
+    title="Obsidian"
+    description="Connect your Obsidian vault to SurfSense"
+    href="/docs/connectors/obsidian"
+  />
+</Cards>
diff --git a/surfsense_web/content/docs/docker-installation/index.mdx b/surfsense_web/content/docs/docker-installation/index.mdx
new file mode 100644
index 000000000..929192164
--- /dev/null
+++ b/surfsense_web/content/docs/docker-installation/index.mdx
@@ -0,0 +1,36 @@
+---
+title: Docker Installation
+description: Deploy SurfSense using Docker
+---
+
+import { Card, Cards } from 'fumadocs-ui/components/card';
+
+Choose your preferred Docker deployment method below.
+
+<Cards>
+  <Card
+    title="One-Line Install Script"
+    description="One-command installation of SurfSense using Docker"
+    href="/docs/docker-installation/install-script"
+  />
+  <Card
+    title="Docker Compose"
+    description="Manual Docker Compose setup for SurfSense"
+    href="/docs/docker-installation/docker-compose"
+  />
+  <Card
+    title="Updating"
+    description="How to update your SurfSense Docker deployment"
+    href="/docs/docker-installation/updating"
+  />
+  <Card
+    title="Docker Compose Development"
+    description="Building SurfSense from source using docker-compose.dev.yml"
+    href="/docs/docker-installation/dev-compose"
+  />
+  <Card
+    title="Migrate from the All-in-One Container"
+    description="Migrate your data from the legacy all-in-one Docker image"
+    href="/docs/docker-installation/migrate-from-allinone"
+  />
+</Cards>
diff --git a/surfsense_web/content/docs/how-to/index.mdx b/surfsense_web/content/docs/how-to/index.mdx
new file mode 100644
index 000000000..de45db19c
--- /dev/null
+++ b/surfsense_web/content/docs/how-to/index.mdx
@@ -0,0 +1,21 @@
+---
+title: How-To Guides
+description: Step-by-step guides for common tasks
+---
+
+import { Card, Cards } from 'fumadocs-ui/components/card';
+
+Practical guides to help you get the most out of SurfSense.
+
+<Cards>
+  <Card
+    title="Electric SQL"
+    description="Setting up Electric SQL for real-time data synchronization"
+    href="/docs/how-to/electric-sql"
+  />
+  <Card
+    title="Realtime Collaboration"
+    description="Invite teammates, share chats, and collaborate in realtime"
+    href="/docs/how-to/realtime-collaboration"
+  />
+</Cards>