+
;
- parentRef: React.RefObject;
- beamOptions?: {
- initialX?: number;
- translateX?: number;
- initialY?: number;
- translateY?: number;
- rotate?: number;
- className?: string;
- duration?: number;
- delay?: number;
- repeatDelay?: number;
- };
- }
->(({ parentRef, containerRef, beamOptions = {} }, ref) => {
+const CollisionMechanism = ({
+ parentRef,
+ beamOptions = {},
+}: {
+ parentRef: React.RefObject;
+ beamOptions?: {
+ initialX?: number;
+ translateX?: number;
+ initialY?: number;
+ translateY?: number;
+ rotate?: number;
+ className?: string;
+ duration?: number;
+ delay?: number;
+ repeatDelay?: number;
+ };
+}) => {
const beamRef = useRef(null);
const [collision, setCollision] = useState<{
detected: boolean;
@@ -264,14 +237,14 @@ const CollisionMechanism = React.forwardRef<
useEffect(() => {
const checkCollision = () => {
- if (beamRef.current && containerRef.current && parentRef.current && !cycleCollisionDetected) {
+ if (beamRef.current && parentRef.current && !cycleCollisionDetected) {
const beamRect = beamRef.current.getBoundingClientRect();
- const containerRect = containerRef.current.getBoundingClientRect();
const parentRect = parentRef.current.getBoundingClientRect();
+ const rightEdge = parentRect.right;
- if (beamRect.bottom >= containerRect.top) {
- const relativeX = beamRect.left - parentRect.left + beamRect.width / 2;
- const relativeY = beamRect.bottom - parentRect.top;
+ if (beamRect.right >= rightEdge - 20) {
+ const relativeX = parentRect.width - 20;
+ const relativeY = beamRect.top - parentRect.top + beamRect.height / 2;
setCollision({
detected: true,
@@ -288,7 +261,7 @@ const CollisionMechanism = React.forwardRef<
const animationInterval = setInterval(checkCollision, 100);
return () => clearInterval(animationInterval);
- }, [cycleCollisionDetected, containerRef]);
+ }, [cycleCollisionDetected, parentRef]);
useEffect(() => {
if (collision.detected && collision.coordinates) {
@@ -354,9 +327,7 @@ const CollisionMechanism = React.forwardRef<
);
-});
-
-CollisionMechanism.displayName = "CollisionMechanism";
+};
const Explosion = ({ ...props }: React.HTMLProps) => {
const spans = Array.from({ length: 20 }, (_, index) => ({
diff --git a/surfsense_web/components/homepage/use-cases-grid.tsx b/surfsense_web/components/homepage/use-cases-grid.tsx
new file mode 100644
index 000000000..21287f587
--- /dev/null
+++ b/surfsense_web/components/homepage/use-cases-grid.tsx
@@ -0,0 +1,107 @@
+"use client";
+
+import { AnimatePresence, motion } from "motion/react";
+import { ExpandedGifOverlay, useExpandedGif } from "@/components/ui/expanded-gif-overlay";
+
+const useCases = [
+ {
+ title: "Search & Citation",
+ description: "Ask questions and get Perplexity-style cited responses from your knowledge base.",
+ src: "/homepage/hero_tutorial/BSNCGif.gif",
+ },
+ {
+ title: "Document Mention QNA",
+ description: "Mention specific documents in your queries for targeted answers.",
+ src: "/homepage/hero_tutorial/BQnaGif_compressed.gif",
+ },
+ {
+ title: "Report Generation",
+ description: "Generate and export reports in many formats.",
+ src: "/homepage/hero_tutorial/ReportGenGif_compressed.gif",
+ },
+ {
+ title: "Podcast Generation",
+ description: "Turn your knowledge into podcasts in under 20 seconds.",
+ src: "/homepage/hero_tutorial/PodcastGenGif.gif",
+ },
+ {
+ title: "Image Generation",
+ description: "Generate images directly from your conversations.",
+ src: "/homepage/hero_tutorial/ImageGenGif.gif",
+ },
+];
+
+function UseCaseCard({
+ title,
+ description,
+ src,
+ className,
+}: {
+ title: string;
+ description: string;
+ src: string;
+ className?: string;
+}) {
+ const { expanded, open, close } = useExpandedGif();
+
+ return (
+ <>
+
+
+
+
+ {expanded &&
+
+ );
+}
+
+export function UseCasesGrid() {
+ return (
+
+
+ );
+}
diff --git a/surfsense_web/components/tool-ui/delete-notion-page.tsx b/surfsense_web/components/tool-ui/delete-notion-page.tsx
index c7a9b282e..bc388b537 100644
--- a/surfsense_web/components/tool-ui/delete-notion-page.tsx
+++ b/surfsense_web/components/tool-ui/delete-notion-page.tsx
@@ -68,7 +68,12 @@ interface WarningResult {
message?: string;
}
-type DeleteNotionPageResult = InterruptResult | SuccessResult | ErrorResult | InfoResult | WarningResult;
+type DeleteNotionPageResult =
+ | InterruptResult
+ | SuccessResult
+ | ErrorResult
+ | InfoResult
+ | WarningResult;
function isInterruptResult(result: unknown): result is InterruptResult {
return (
@@ -341,22 +346,23 @@ function SuccessCard({ result }: { result: SuccessResult }) {
-
);
@@ -236,24 +210,23 @@ const BackgroundGrids = () => {
);
};
-const CollisionMechanism = React.forwardRef<
- HTMLDivElement,
- {
- containerRef: React.RefObject
- {/* Light mode image */}
-
+
+
+ 
+
+
+
+ {title}
+{description}
+
+
+
+ {/* First row: 2 larger cards */}
+ + What You Can Do +
+
+ {useCases.slice(0, 2).map((useCase) => (
+
+
+ {/* Second row: 3 equal cards */}
+
+ {useCases.slice(2).map((useCase) => (
+
+
+ + And more coming soon. +
+
- {result.title && (
-
)}
+ {(result.deleted_from_db || result.title) && (
+
- Deleted page:
- {result.title}
-
- )}
- {result.deleted_from_db && (
-
-
- ✓ Also removed from knowledge base
-
-
- )}
-
+ {result.title && (
+
+ )}
);
}
diff --git a/surfsense_web/components/ui/expanded-gif-overlay.tsx b/surfsense_web/components/ui/expanded-gif-overlay.tsx
new file mode 100644
index 000000000..56f343ded
--- /dev/null
+++ b/surfsense_web/components/ui/expanded-gif-overlay.tsx
@@ -0,0 +1,53 @@
+"use client";
+
+import { AnimatePresence, motion } from "motion/react";
+import { useCallback, useEffect, useState } from "react";
+
+function ExpandedGifOverlay({
+ src,
+ alt,
+ onClose,
+}: {
+ src: string;
+ alt: string;
+ onClose: () => void;
+}) {
+ useEffect(() => {
+ const handleKey = (e: KeyboardEvent) => {
+ if (e.key === "Escape") onClose();
+ };
+ document.addEventListener("keydown", handleKey);
+ return () => document.removeEventListener("keydown", handleKey);
+ }, [onClose]);
+
+ return (
+
+ Deleted page:
+ {result.title}
+
+ )}
+ {result.deleted_from_db && (
+
+
+ ✓ Also removed from knowledge base
+
+
+ )}
+
+
+
+
+
+
+
+ {step}
+
+
+
+
+ + {title} +
++ {description} +
+
+
+
+
+ {walkthroughSteps.map((project, i) => {
+ const targetScale = Math.max(0.6, 1 - (walkthroughSteps.length - i - 1) * 0.05);
+ return (
+
+ );
+}
+
+export { WalkthroughScroll, WalkthroughCard };
diff --git a/surfsense_web/content/docs/manual-installation.mdx b/surfsense_web/content/docs/manual-installation.mdx
index b4da781ba..1d30a12ef 100644
--- a/surfsense_web/content/docs/manual-installation.mdx
+++ b/surfsense_web/content/docs/manual-installation.mdx
@@ -278,8 +278,9 @@ In a new terminal window, start the Celery worker to handle background tasks:
# Make sure you're in the surfsense_backend directory
cd surfsense_backend
-# Start Celery worker
-uv run celery -A celery_worker.celery_app worker --loglevel=info --concurrency=1 --pool=solo
+# Start Celery worker (consume both default and connectors queues)
+DEFAULT_Q="${CELERY_TASK_DEFAULT_QUEUE:-surfsense}"
+uv run celery -A celery_worker.celery_app worker --loglevel=info --concurrency=1 --pool=solo --queues="${DEFAULT_Q},${DEFAULT_Q}.connectors"
```
**If using pip/venv:**
@@ -293,8 +294,9 @@ source .venv/bin/activate # Linux/macOS
# OR
.venv\Scripts\activate # Windows
-# Start Celery worker
-celery -A celery_worker.celery_app worker --loglevel=info --concurrency=1 --pool=solo
+# Start Celery worker (consume both default and connectors queues)
+DEFAULT_Q="${CELERY_TASK_DEFAULT_QUEUE:-surfsense}"
+celery -A celery_worker.celery_app worker --loglevel=info --concurrency=1 --pool=solo --queues="${DEFAULT_Q},${DEFAULT_Q}.connectors"
```
**Optional: Start Flower for monitoring Celery tasks:**
diff --git a/surfsense_web/contracts/types/connector.types.ts b/surfsense_web/contracts/types/connector.types.ts
index a7760745d..3a11d0399 100644
--- a/surfsense_web/contracts/types/connector.types.ts
+++ b/surfsense_web/contracts/types/connector.types.ts
@@ -133,7 +133,10 @@ export const updateConnectorResponse = searchSourceConnector;
export const deleteConnectorRequest = searchSourceConnector.pick({ id: true });
export const deleteConnectorResponse = z.object({
- message: z.literal("Search source connector deleted successfully"),
+ message: z.string(),
+ status: z.string().optional(),
+ connector_id: z.number().optional(),
+ connector_name: z.string().optional(),
});
/**
diff --git a/surfsense_web/hooks/use-comments-electric.ts b/surfsense_web/hooks/use-comments-electric.ts
index b90f52dce..6ca7748b5 100644
--- a/surfsense_web/hooks/use-comments-electric.ts
+++ b/surfsense_web/hooks/use-comments-electric.ts
@@ -393,11 +393,19 @@ export function useCommentsElectric(threadId: number | null) {
}
if (syncHandleRef.current) {
- syncHandleRef.current.unsubscribe();
+ try {
+ syncHandleRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
syncHandleRef.current = null;
}
if (liveQueryRef.current) {
- liveQueryRef.current.unsubscribe();
+ try {
+ liveQueryRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
liveQueryRef.current = null;
}
};
diff --git a/surfsense_web/hooks/use-connectors-electric.ts b/surfsense_web/hooks/use-connectors-electric.ts
index 08ef0621d..951f1d15a 100644
--- a/surfsense_web/hooks/use-connectors-electric.ts
+++ b/surfsense_web/hooks/use-connectors-electric.ts
@@ -180,11 +180,19 @@ export function useConnectorsElectric(searchSpaceId: number | string | null) {
syncKeyRef.current = null;
if (syncHandleRef.current) {
- syncHandleRef.current.unsubscribe();
+ try {
+ syncHandleRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
syncHandleRef.current = null;
}
if (liveQueryRef.current) {
- liveQueryRef.current.unsubscribe();
+ try {
+ liveQueryRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
liveQueryRef.current = null;
}
};
diff --git a/surfsense_web/hooks/use-documents.ts b/surfsense_web/hooks/use-documents.ts
index 6060b9572..e3a315cd1 100644
--- a/surfsense_web/hooks/use-documents.ts
+++ b/surfsense_web/hooks/use-documents.ts
@@ -230,11 +230,19 @@ export function useDocuments(
async function setupElectricRealtime() {
// Cleanup previous subscriptions
if (syncHandleRef.current) {
- syncHandleRef.current.unsubscribe();
+ try {
+ syncHandleRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
syncHandleRef.current = null;
}
if (liveQueryRef.current) {
- liveQueryRef.current.unsubscribe?.();
+ try {
+ liveQueryRef.current.unsubscribe?.();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
liveQueryRef.current = null;
}
@@ -420,11 +428,19 @@ export function useDocuments(
return () => {
mounted = false;
if (syncHandleRef.current) {
- syncHandleRef.current.unsubscribe();
+ try {
+ syncHandleRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
syncHandleRef.current = null;
}
if (liveQueryRef.current) {
- liveQueryRef.current.unsubscribe?.();
+ try {
+ liveQueryRef.current.unsubscribe?.();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
liveQueryRef.current = null;
}
};
diff --git a/surfsense_web/hooks/use-inbox.ts b/surfsense_web/hooks/use-inbox.ts
index 56ddb46a4..d30fc607e 100644
--- a/surfsense_web/hooks/use-inbox.ts
+++ b/surfsense_web/hooks/use-inbox.ts
@@ -131,7 +131,11 @@ export function useInbox(
// Clean up previous sync
if (syncHandleRef.current) {
- syncHandleRef.current.unsubscribe();
+ try {
+ syncHandleRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
syncHandleRef.current = null;
}
@@ -174,7 +178,11 @@ export function useInbox(
mounted = false;
userSyncKeyRef.current = null;
if (syncHandleRef.current) {
- syncHandleRef.current.unsubscribe();
+ try {
+ syncHandleRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
syncHandleRef.current = null;
}
};
@@ -199,7 +207,11 @@ export function useInbox(
async function setupLiveQuery() {
// Clean up previous live query
if (liveQueryRef.current) {
- liveQueryRef.current.unsubscribe();
+ try {
+ liveQueryRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
liveQueryRef.current = null;
}
@@ -297,7 +309,11 @@ export function useInbox(
return () => {
mounted = false;
if (liveQueryRef.current) {
- liveQueryRef.current.unsubscribe();
+ try {
+ liveQueryRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
liveQueryRef.current = null;
}
};
diff --git a/surfsense_web/hooks/use-messages-electric.ts b/surfsense_web/hooks/use-messages-electric.ts
index e8c82e92b..728503de9 100644
--- a/surfsense_web/hooks/use-messages-electric.ts
+++ b/surfsense_web/hooks/use-messages-electric.ts
@@ -142,11 +142,19 @@ export function useMessagesElectric(
syncKeyRef.current = null;
if (syncHandleRef.current) {
- syncHandleRef.current.unsubscribe();
+ try {
+ syncHandleRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
syncHandleRef.current = null;
}
if (liveQueryRef.current) {
- liveQueryRef.current.unsubscribe();
+ try {
+ liveQueryRef.current.unsubscribe();
+ } catch {
+ // PGlite may already be closed during cleanup
+ }
liveQueryRef.current = null;
}
};
diff --git a/surfsense_web/package.json b/surfsense_web/package.json
index 820a24725..d98ce2338 100644
--- a/surfsense_web/package.json
+++ b/surfsense_web/package.json
@@ -102,6 +102,7 @@
"jotai": "^2.15.1",
"jotai-tanstack-query": "^0.11.0",
"katex": "^0.16.28",
+ "lenis": "^1.3.17",
"lowlight": "^3.3.0",
"lucide-react": "^0.477.0",
"motion": "^12.23.22",
diff --git a/surfsense_web/pnpm-lock.yaml b/surfsense_web/pnpm-lock.yaml
index 195795dea..b4aff819d 100644
--- a/surfsense_web/pnpm-lock.yaml
+++ b/surfsense_web/pnpm-lock.yaml
@@ -251,6 +251,9 @@ importers:
katex:
specifier: ^0.16.28
version: 0.16.28
+ lenis:
+ specifier: ^1.3.17
+ version: 1.3.17(react@19.2.3)
lowlight:
specifier: ^3.3.0
version: 3.3.0
@@ -5873,6 +5876,20 @@ packages:
resolution: {integrity: sha512-MbjN408fEndfiQXbFQ1vnd+1NoLDsnQW41410oQBXiyXDMYH5z505juWa4KUE1LqxRC7DgOgZDbKLxHIwm27hA==}
engines: {node: '>=0.10'}
+ lenis@1.3.17:
+ resolution: {integrity: sha512-k9T9rgcxne49ggJOvXCraWn5dt7u2mO+BNkhyu6yxuEnm9c092kAW5Bus5SO211zUvx7aCCEtzy9UWr0RB+oJw==}
+ peerDependencies:
+ '@nuxt/kit': '>=3.0.0'
+ react: '>=17.0.0'
+ vue: '>=3.0.0'
+ peerDependenciesMeta:
+ '@nuxt/kit':
+ optional: true
+ react:
+ optional: true
+ vue:
+ optional: true
+
levn@0.4.1:
resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==}
engines: {node: '>= 0.8.0'}
@@ -13666,6 +13683,10 @@ snapshots:
dependencies:
language-subtag-registry: 0.3.23
+ lenis@1.3.17(react@19.2.3):
+ optionalDependencies:
+ react: 19.2.3
+
levn@0.4.1:
dependencies:
prelude-ls: 1.2.1
diff --git a/surfsense_web/public/homepage/hero_tutorial/BQnaGif_compressed.gif b/surfsense_web/public/homepage/hero_tutorial/BQnaGif_compressed.gif
new file mode 100644
index 000000000..43b182f05
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/BQnaGif_compressed.gif differ
diff --git a/surfsense_web/public/homepage/hero_tutorial/BSNCGif.gif b/surfsense_web/public/homepage/hero_tutorial/BSNCGif.gif
new file mode 100644
index 000000000..f60c94783
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/BSNCGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_tutorial/ConnectorFlowGif.gif b/surfsense_web/public/homepage/hero_tutorial/ConnectorFlowGif.gif
new file mode 100644
index 000000000..de3330f51
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/ConnectorFlowGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_tutorial/DocUploadGif.gif b/surfsense_web/public/homepage/hero_tutorial/DocUploadGif.gif
new file mode 100644
index 000000000..9e7b0ed58
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/DocUploadGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_tutorial/ImageGenGif.gif b/surfsense_web/public/homepage/hero_tutorial/ImageGenGif.gif
new file mode 100644
index 000000000..618672679
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/ImageGenGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_tutorial/LoginFlowGif.gif b/surfsense_web/public/homepage/hero_tutorial/LoginFlowGif.gif
new file mode 100644
index 000000000..20999f9f0
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/LoginFlowGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_tutorial/PodcastGenGif.gif b/surfsense_web/public/homepage/hero_tutorial/PodcastGenGif.gif
new file mode 100644
index 000000000..4d85f90a3
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/PodcastGenGif.gif differ
diff --git a/surfsense_web/public/homepage/hero_tutorial/ReportGenGif_compressed.gif b/surfsense_web/public/homepage/hero_tutorial/ReportGenGif_compressed.gif
new file mode 100644
index 000000000..074bd4299
Binary files /dev/null and b/surfsense_web/public/homepage/hero_tutorial/ReportGenGif_compressed.gif differ
diff --git a/surfsense_web/public/homepage/temp_hero_dark.png b/surfsense_web/public/homepage/temp_hero_dark.png
deleted file mode 100644
index 92f4284a7..000000000
Binary files a/surfsense_web/public/homepage/temp_hero_dark.png and /dev/null differ
diff --git a/surfsense_web/public/homepage/temp_hero_light.png b/surfsense_web/public/homepage/temp_hero_light.png
deleted file mode 100644
index d7a0734cf..000000000
Binary files a/surfsense_web/public/homepage/temp_hero_light.png and /dev/null differ