diff --git a/README.es.md b/README.es.md
index 94d030186..b3f2eb5c3 100644
--- a/README.es.md
+++ b/README.es.md
@@ -74,6 +74,8 @@ https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
diff --git a/surfsense_web/components/homepage/use-cases-grid.tsx b/surfsense_web/components/homepage/use-cases-grid.tsx
index 21287f587..b835703aa 100644
--- a/surfsense_web/components/homepage/use-cases-grid.tsx
+++ b/surfsense_web/components/homepage/use-cases-grid.tsx
@@ -29,6 +29,16 @@ const useCases = [
description: "Generate images directly from your conversations.",
src: "/homepage/hero_tutorial/ImageGenGif.gif",
},
+ {
+ title: "Realtime Chat",
+ description: "Chat together in realtime with your team.",
+ src: "/homepage/hero_realtime/RealTimeChatGif.gif",
+ },
+ {
+ title: "Realtime Comments",
+ description: "Add comments and tag teammates on any message.",
+ src: "/homepage/hero_realtime/RealTimeCommentsFlow.gif",
+ },
];
function UseCaseCard({
@@ -85,16 +95,23 @@ export function UseCasesGrid() {
- {/* First row: 2 larger cards */}
+ {/* Row 1: 2 larger cards */}
{useCases.slice(0, 2).map((useCase) => (
))}
- {/* Second row: 3 equal cards */}
+ {/* Row 2: 3 equal cards */}
- {useCases.slice(2).map((useCase) => (
+ {useCases.slice(2, 5).map((useCase) => (
+
+ ))}
+
+
+ {/* Row 3: 2 cards */}
+
+ {useCases.slice(5).map((useCase) => (
))}
diff --git a/surfsense_web/content/docs/how-to/meta.json b/surfsense_web/content/docs/how-to/meta.json
index 2f0da4ff1..9051b0585 100644
--- a/surfsense_web/content/docs/how-to/meta.json
+++ b/surfsense_web/content/docs/how-to/meta.json
@@ -1,5 +1,5 @@
{
"title": "How to",
- "pages": ["electric-sql"],
+ "pages": ["electric-sql", "realtime-collaboration"],
"defaultOpen": false
}
diff --git a/surfsense_web/content/docs/how-to/realtime-collaboration.mdx b/surfsense_web/content/docs/how-to/realtime-collaboration.mdx
new file mode 100644
index 000000000..73032c798
--- /dev/null
+++ b/surfsense_web/content/docs/how-to/realtime-collaboration.mdx
@@ -0,0 +1,40 @@
+---
+title: Realtime Collaboration
+description: How to invite teammates, share chats, and collaborate in realtime on SurfSense
+---
+
+# Realtime Collaboration
+
+SurfSense supports realtime collaboration so your team can work together on shared Search Spaces and chats. This guide walks you through the full setup.
+
+## Step 1: Invite Members
+
+Go to the **Manage Members** page in your Search Space and create an invite for your teammates.
+
+
+
+## Step 2: Teammate Joins
+
+Your teammate accepts the invite and the Search Space becomes shared between you.
+
+
+
+## Step 3: Make Chat Shared
+
+Toggle any chat to **Shared** so your team can see and participate in it.
+
+
+
+## Step 4: Chat in Realtime
+
+Your team can now chat together in realtime. Messages appear instantly for all participants.
+
+
+
+## Step 5: Add Comments
+
+Tag teammates by adding comments on any message. Great for reviews, feedback, or follow-ups.
+
+
+
+
diff --git a/surfsense_web/public/homepage/hero_realtime/InviteJoinFlow.gif b/surfsense_web/public/homepage/hero_realtime/InviteJoinFlow.gif
new file mode 100644
index 000000000..8621d831f
Binary files /dev/null and b/surfsense_web/public/homepage/hero_realtime/InviteJoinFlow.gif differ
diff --git a/surfsense_web/public/homepage/hero_realtime/InviteMembersGif.gif b/surfsense_web/public/homepage/hero_realtime/InviteMembersGif.gif
new file mode 100644
index 000000000..21cd4980a
Binary files /dev/null and b/surfsense_web/public/homepage/hero_realtime/InviteMembersGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_realtime/MakeChatSharedGif.gif b/surfsense_web/public/homepage/hero_realtime/MakeChatSharedGif.gif
new file mode 100644
index 000000000..4cae08592
Binary files /dev/null and b/surfsense_web/public/homepage/hero_realtime/MakeChatSharedGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_realtime/RealTimeChatGif.gif b/surfsense_web/public/homepage/hero_realtime/RealTimeChatGif.gif
new file mode 100644
index 000000000..35d0fced1
Binary files /dev/null and b/surfsense_web/public/homepage/hero_realtime/RealTimeChatGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_realtime/RealTimeCommentsFlow.gif b/surfsense_web/public/homepage/hero_realtime/RealTimeCommentsFlow.gif
new file mode 100644
index 000000000..835cdb655
Binary files /dev/null and b/surfsense_web/public/homepage/hero_realtime/RealTimeCommentsFlow.gif differ