@@ -317,8 +306,13 @@ export function ArtifactFilePreview({
);
}
diff --git a/frontend/src/content/en/index.mdx b/frontend/src/content/en/index.mdx
index 0dd2efe12..e289d8f3b 100644
--- a/frontend/src/content/en/index.mdx
+++ b/frontend/src/content/en/index.mdx
@@ -20,27 +20,27 @@ If you want to understand how DeerFlow works, start with the Introduction. If yo
Start with the conceptual overview first.
-- [Introduction](/docs/introduction)
-- [Why DeerFlow](/docs/introduction/why-deerflow)
-- [Harness vs App](/docs/introduction/harness-vs-app)
+- [Introduction](./docs/introduction)
+- [Why DeerFlow](./docs/introduction/why-deerflow)
+- [Harness vs App](./docs/introduction/harness-vs-app)
### If you want to build with DeerFlow
Start with the Harness section. This path is for teams who want to integrate DeerFlow capabilities into their own system or build a custom agent product on top of the DeerFlow runtime.
-- [DeerFlow Harness](/docs/harness)
-- [Quick Start](/docs/harness/quick-start)
-- [Configuration](/docs/harness/configuration)
-- [Customization](/docs/harness/customization)
+- [DeerFlow Harness](./docs/harness)
+- [Quick Start](./docs/harness/quick-start)
+- [Configuration](./docs/harness/configuration)
+- [Customization](./docs/harness/customization)
### If you want to deploy and use DeerFlow
Start with the App section. This path is for teams who want to run DeerFlow as a complete application and understand how to configure, operate, and use it in practice.
-- [DeerFlow App](/docs/app)
-- [Quick Start](/docs/app/quick-start)
-- [Deployment Guide](/docs/app/deployment-guide)
-- [Workspace Usage](/docs/app/workspace-usage)
+- [DeerFlow App](./docs/app)
+- [Quick Start](./docs/app/quick-start)
+- [Deployment Guide](./docs/app/deployment-guide)
+- [Workspace Usage](./docs/app/workspace-usage)
## Documentation structure
@@ -79,17 +79,17 @@ The App section is written for teams who want to deploy DeerFlow as a usable pro
The Tutorials section is for hands-on, task-oriented learning.
-- [Tutorials](/docs/tutorials)
+- [Tutorials](./docs/tutorials)
### Reference
The Reference section is for detailed lookup material, including configuration, runtime modes, APIs, and source-oriented mapping.
-- [Reference](/docs/reference)
+- [Reference](./docs/reference)
## Choose the right path
-- If you are **evaluating the project**, start with [Introduction](/docs/introduction).
-- If you are **building your own agent system**, start with [DeerFlow Harness](/docs/harness).
-- If you are **deploying DeerFlow for users**, start with [DeerFlow App](/docs/app).
-- If you want to **learn by doing**, go to [Tutorials](/docs/tutorials).
+- If you are **evaluating the project**, start with [Introduction](./docs/introduction).
+- If you are **building your own agent system**, start with [DeerFlow Harness](./docs/harness).
+- If you are **deploying DeerFlow for users**, start with [DeerFlow App](./docs/app).
+- If you want to **learn by doing**, go to [Tutorials](./docs/tutorials).
diff --git a/frontend/src/content/en/posts/releases/2_0_rc.mdx b/frontend/src/content/en/posts/releases/2_0_rc.mdx
new file mode 100644
index 000000000..9977bca1c
--- /dev/null
+++ b/frontend/src/content/en/posts/releases/2_0_rc.mdx
@@ -0,0 +1,9 @@
+---
+title: DeerFlow 2.0 RC
+description: DeerFlow 2.0 RC is officially in RC. Here's what you need to know.
+date: 2026-04-08
+tags:
+ - Release
+---
+
+## DeerFlow 2.0 RC Release
diff --git a/frontend/src/content/zh/index.mdx b/frontend/src/content/zh/index.mdx
index 5f2a18deb..912991b06 100644
--- a/frontend/src/content/zh/index.mdx
+++ b/frontend/src/content/zh/index.mdx
@@ -20,27 +20,27 @@ DeerFlow 是一个用于构建和运行 Agent 系统的框架。它提供了一
先从概念概述开始。
-- [简介](/docs/introduction)
-- [为什么选择 DeerFlow](/docs/introduction/why-deerflow)
-- [Harness 与应用的区别](/docs/introduction/harness-vs-app)
+- [简介](./docs/introduction)
+- [为什么选择 DeerFlow](./docs/introduction/why-deerflow)
+- [Harness 与应用的区别](./docs/introduction/harness-vs-app)
### 如果你想基于 DeerFlow 进行开发
从 Harness 章节开始。这条路径适合想将 DeerFlow 功能集成到自己系统中，或基于 DeerFlow 运行时构建自定义 Agent 产品的团队。
-- [DeerFlow Harness](/docs/harness)
-- [快速上手](/docs/harness/quick-start)
-- [配置](/docs/harness/configuration)
-- [自定义与扩展](/docs/harness/customization)
+- [DeerFlow Harness](./docs/harness)
+- [快速上手](./docs/harness/quick-start)
+- [配置](./docs/harness/configuration)
+- [自定义与扩展](./docs/harness/customization)
### 如果你想部署和使用 DeerFlow
从应用章节开始。这条路径适合想将 DeerFlow 作为完整应用运行，并了解如何配置、运维和实际使用的团队。
-- [DeerFlow 应用](/docs/application)
-- [快速上手](/docs/application/quick-start)
-- [部署指南](/docs/application/deployment-guide)
-- [工作区使用](/docs/application/workspace-usage)
+- [DeerFlow 应用](./docs/application)
+- [快速上手](./docs/application/quick-start)
+- [部署指南](./docs/application/deployment-guide)
+- [工作区使用](./docs/application/workspace-usage)
## 文档结构
diff --git a/frontend/src/core/api/api-client.ts b/frontend/src/core/api/api-client.ts
index 0b4532ca9..88f8658b1 100644
--- a/frontend/src/core/api/api-client.ts
+++ b/frontend/src/core/api/api-client.ts
@@ -3,6 +3,13 @@
import { Client as LangGraphClient } from "@langchain/langgraph-sdk/client";
import { getLangGraphBaseURL } from "../config";
+import { isStaticWebsiteOnly } from "../static-mode";
+import {
+ loadStaticDemoThread,
+ loadStaticDemoThreads,
+ staticDemoThreadState,
+} from "../threads/static-demo";
+import type { AgentThreadState } from "../threads/types";
import { isStateChangingMethod, readCsrfCookie } from "./fetcher";
import { sanitizeRunStreamOptions } from "./stream-mode";
@@ -32,6 +39,10 @@ function injectCsrfHeader(_url: URL, init: RequestInit): RequestInit {
}
function createCompatibleClient(isMock?: boolean): LangGraphClient {
+ if (isStaticWebsiteOnly() && !isMock) {
+ return createStaticClient();
+ }
+
const apiUrl = getLangGraphBaseURL(isMock);
console.log(`Creating API client with base URL: ${apiUrl}`);
const client = new LangGraphClient({
@@ -58,6 +69,41 @@ function createCompatibleClient(isMock?: boolean): LangGraphClient {
return client;
}
+function createStaticClient(): LangGraphClient {
+ const apiUrl =
+ typeof window === "undefined"
+ ? "http://localhost:3000"
+ : window.location.origin;
+ const client = new LangGraphClient({ apiUrl });
+
+ client.threads.search = (async (query) => {
+ return loadStaticDemoThreads(query);
+ }) as typeof client.threads.search;
+
+ client.threads.get = (async (threadId) => {
+ return loadStaticDemoThread(threadId);
+ }) as typeof client.threads.get;
+
+ client.threads.getState = (async (threadId) => {
+ return staticDemoThreadState(await loadStaticDemoThread(threadId));
+ }) as typeof client.threads.getState;
+
+ client.threads.getHistory = (async (threadId) => {
+ return [staticDemoThreadState(await loadStaticDemoThread(threadId))];
+ }) as typeof client.threads.getHistory;
+
+ client.threads.update = (async (threadId) => {
+ return loadStaticDemoThread(threadId);
+ }) as typeof client.threads.update;
+
+ client.runs.list = (async () => []) as typeof client.runs.list;
+ client.runs.stream = async function* () {} as typeof client.runs.stream;
+ client.runs.joinStream =
+ async function* () {} as typeof client.runs.joinStream;
+
+ return client as LangGraphClient
;
+}
+
const _clients = new Map();
export function getAPIClient(isMock?: boolean): LangGraphClient {
const cacheKey = isMock ? "mock" : "default";
diff --git a/frontend/src/core/artifacts/utils.ts b/frontend/src/core/artifacts/utils.ts
index 402696504..3dc8aa1c3 100644
--- a/frontend/src/core/artifacts/utils.ts
+++ b/frontend/src/core/artifacts/utils.ts
@@ -1,4 +1,5 @@
import { getBackendBaseURL } from "../config";
+import { isStaticWebsiteOnly } from "../static-mode";
import type { AgentThread } from "../threads";
export function urlOfArtifact({
@@ -12,7 +13,7 @@ export function urlOfArtifact({
download?: boolean;
isMock?: boolean;
}) {
- if (isMock) {
+ if (isMock || isStaticWebsiteOnly()) {
return `${getBackendBaseURL()}/mock/api/threads/${threadId}/artifacts${filepath}${download ? "?download=true" : ""}`;
}
return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${filepath}${download ? "?download=true" : ""}`;
@@ -23,5 +24,8 @@ export function extractArtifactsFromThread(thread: AgentThread) {
}
export function resolveArtifactURL(absolutePath: string, threadId: string) {
+ if (isStaticWebsiteOnly()) {
+ return `${getBackendBaseURL()}/mock/api/threads/${threadId}/artifacts${absolutePath}`;
+ }
return `${getBackendBaseURL()}/api/threads/${threadId}/artifacts${absolutePath}`;
}
diff --git a/frontend/src/core/auth/AuthProvider.tsx b/frontend/src/core/auth/AuthProvider.tsx
index 652cc49b8..8614027bd 100644
--- a/frontend/src/core/auth/AuthProvider.tsx
+++ b/frontend/src/core/auth/AuthProvider.tsx
@@ -10,6 +10,7 @@ import React, {
type ReactNode,
} from "react";
+import { isStaticWebsiteOnly } from "../static-mode";
import { type User, buildLoginUrl } from "./types";
// Re-export for consumers
@@ -46,6 +47,7 @@ export function AuthProvider({ children, initialUser }: AuthProviderProps) {
const [isLoading, setIsLoading] = useState(false);
const router = useRouter();
const pathname = usePathname();
+ const staticMode = isStaticWebsiteOnly();
const isAuthenticated = user !== null;
@@ -54,6 +56,8 @@ export function AuthProvider({ children, initialUser }: AuthProviderProps) {
* Used when initialUser might be stale (e.g., after tab was inactive)
*/
const refreshUser = useCallback(async () => {
+ if (staticMode) return;
+
try {
setIsLoading(true);
const res = await fetch("/api/v1/auth/me", {
@@ -77,7 +81,7 @@ export function AuthProvider({ children, initialUser }: AuthProviderProps) {
} finally {
setIsLoading(false);
}
- }, [pathname, router]);
+ }, [staticMode, pathname, router]);
/**
* Logout - call FastAPI logout endpoint and clear local state
@@ -87,6 +91,11 @@ export function AuthProvider({ children, initialUser }: AuthProviderProps) {
// Immediately clear local state to prevent UI flicker
setUser(null);
+ if (staticMode) {
+ router.push("/");
+ return;
+ }
+
try {
await fetch("/api/v1/auth/logout", {
method: "POST",
@@ -99,7 +108,7 @@ export function AuthProvider({ children, initialUser }: AuthProviderProps) {
// Redirect to home page
router.push("/");
- }, [router]);
+ }, [staticMode, router]);
/**
* Handle visibility change - refresh user when tab becomes visible again.
@@ -108,6 +117,8 @@ export function AuthProvider({ children, initialUser }: AuthProviderProps) {
const lastCheckRef = React.useRef(0);
useEffect(() => {
+ if (staticMode) return;
+
const handleVisibilityChange = () => {
if (document.visibilityState !== "visible" || user === null) return;
const now = Date.now();
@@ -120,7 +131,7 @@ export function AuthProvider({ children, initialUser }: AuthProviderProps) {
return () => {
document.removeEventListener("visibilitychange", handleVisibilityChange);
};
- }, [user, refreshUser]);
+ }, [staticMode, user, refreshUser]);
const value: AuthContextType = {
user,
@@ -155,6 +166,8 @@ export function useRequireAuth(): AuthContextType {
const pathname = usePathname();
useEffect(() => {
+ if (isStaticWebsiteOnly()) return;
+
// Only redirect if we're sure user is not authenticated (not just loading)
if (!auth.isLoading && !auth.isAuthenticated) {
router.push(buildLoginUrl(pathname || "/workspace"));
diff --git a/frontend/src/core/auth/server.ts b/frontend/src/core/auth/server.ts
index 6ca3195c4..c3e085793 100644
--- a/frontend/src/core/auth/server.ts
+++ b/frontend/src/core/auth/server.ts
@@ -1,6 +1,8 @@
import { cookies } from "next/headers";
import { getGatewayConfig } from "./gateway-config";
+import { isStaticWebsiteOnly } from "../static-mode";
+import { STATIC_WEBSITE_USER } from "./static-user";
import { type AuthResult, userSchema } from "./types";
const SSR_AUTH_TIMEOUT_MS = 5_000;
@@ -10,6 +12,13 @@ const SSR_AUTH_TIMEOUT_MS = 5_000;
* Returns a tagged AuthResult — callers use exhaustive switch, no try/catch.
*/
export async function getServerSideUser(): Promise {
+ if (isStaticWebsiteOnly()) {
+ return {
+ tag: "authenticated",
+ user: STATIC_WEBSITE_USER,
+ };
+ }
+
if (process.env.DEER_FLOW_AUTH_DISABLED === "1") {
return {
tag: "authenticated",
diff --git a/frontend/src/core/auth/static-user.ts b/frontend/src/core/auth/static-user.ts
new file mode 100644
index 000000000..31615e1d4
--- /dev/null
+++ b/frontend/src/core/auth/static-user.ts
@@ -0,0 +1,8 @@
+import type { User } from "./types";
+
+export const STATIC_WEBSITE_USER: User = {
+ id: "static-website-user",
+ email: "static@example.local",
+ system_role: "admin",
+ needs_setup: false,
+};
diff --git a/frontend/src/core/models/api.ts b/frontend/src/core/models/api.ts
index 46675bf6d..d924e3529 100644
--- a/frontend/src/core/models/api.ts
+++ b/frontend/src/core/models/api.ts
@@ -1,8 +1,18 @@
import { getBackendBaseURL } from "../config";
+import { isStaticWebsiteOnly } from "../static-mode";
import type { ModelsResponse } from "./types";
+const STATIC_MODELS_RESPONSE: ModelsResponse = {
+ models: [],
+ token_usage: { enabled: false },
+};
+
export async function loadModels(): Promise {
+ if (isStaticWebsiteOnly()) {
+ return STATIC_MODELS_RESPONSE;
+ }
+
const res = await fetch(`${getBackendBaseURL()}/api/models`);
const data = (await res.json()) as Partial;
return {
diff --git a/frontend/src/core/static-mode.ts b/frontend/src/core/static-mode.ts
new file mode 100644
index 000000000..2d035f128
--- /dev/null
+++ b/frontend/src/core/static-mode.ts
@@ -0,0 +1,5 @@
+import { env } from "@/env";
+
+export function isStaticWebsiteOnly() {
+ return env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true";
+}
diff --git a/frontend/src/core/threads/static-demo.ts b/frontend/src/core/threads/static-demo.ts
new file mode 100644
index 000000000..db107bdd3
--- /dev/null
+++ b/frontend/src/core/threads/static-demo.ts
@@ -0,0 +1,87 @@
+import type { ThreadsClient } from "@langchain/langgraph-sdk/client";
+import type { ThreadState } from "@langchain/langgraph-sdk";
+
+import type { AgentThread, AgentThreadState } from "./types";
+
+export const DEMO_THREAD_IDS = [
+ "21cfea46-34bd-4aa6-9e1f-3009452fbeb9",
+ "3823e443-4e2b-4679-b496-a9506eae462b",
+ "4f3e55ee-f853-43db-bfb3-7d1a411f03cb",
+ "5aa47db1-d0cb-4eb9-aea5-3dac1b371c5a",
+ "7cfa5f8f-a2f8-47ad-acbd-da7137baf990",
+ "7f9dc56c-e49c-4671-a3d2-c492ff4dce0c",
+ "90040b36-7eba-4b97-ba89-02c3ad47a8b9",
+ "ad76c455-5bf9-4335-8517-fc03834ab828",
+ "b83fbb2a-4e36-4d82-9de0-7b2a02c2092a",
+ "c02bb4d5-4202-490e-ae8f-ff4864fc0d2e",
+ "d3e5adaf-084c-4dd5-9d29-94f1d6bccd98",
+ "f4125791-0128-402a-8ca9-50e0947557e4",
+ "fe3f7974-1bcb-4a01-a950-79673baafefd",
+] as const;
+
+export type ThreadSearchParams = NonNullable<
+ Parameters[0]
+>;
+
+export async function loadStaticDemoThreads(
+ params: ThreadSearchParams = {},
+): Promise {
+ const threads = await Promise.all(
+ DEMO_THREAD_IDS.map((threadId) => loadStaticDemoThread(threadId)),
+ );
+
+ const sortBy = params.sortBy ?? "updated_at";
+ const sortOrder = params.sortOrder ?? "desc";
+ const sortedThreads = [...threads].sort((a, b) => {
+ const aTimestamp = (a as unknown as Record)[sortBy];
+ const bTimestamp = (b as unknown as Record)[sortBy];
+ const aParsed = typeof aTimestamp === "string" ? Date.parse(aTimestamp) : 0;
+ const bParsed = typeof bTimestamp === "string" ? Date.parse(bTimestamp) : 0;
+ const aValue = Number.isNaN(aParsed) ? 0 : aParsed;
+ const bValue = Number.isNaN(bParsed) ? 0 : bParsed;
+ return sortOrder === "asc" ? aValue - bValue : bValue - aValue;
+ });
+
+ const offset = Math.max(0, Math.floor(params.offset ?? 0));
+ const limit =
+ typeof params.limit === "number"
+ ? Math.max(0, Math.floor(params.limit))
+ : sortedThreads.length;
+ return sortedThreads.slice(offset, offset + limit);
+}
+
+export async function loadStaticDemoThread(
+ threadId: string,
+): Promise {
+ const response = await globalThis.fetch(
+ `/demo/threads/${encodeURIComponent(threadId)}/thread.json`,
+ );
+ if (!response.ok) {
+ throw new Error(`Failed to load demo thread ${threadId}`);
+ }
+ const thread = (await response.json()) as AgentThread;
+ return {
+ ...thread,
+ thread_id: threadId,
+ updated_at: thread.updated_at ?? thread.created_at,
+ };
+}
+
+export function staticDemoThreadState(
+ thread: AgentThread,
+): ThreadState {
+ return {
+ values: thread.values,
+ next: [],
+ checkpoint: {
+ thread_id: thread.thread_id,
+ checkpoint_ns: "",
+ checkpoint_id: null,
+ checkpoint_map: null,
+ },
+ metadata: thread.metadata ?? null,
+ created_at: thread.updated_at ?? thread.created_at ?? null,
+ parent_checkpoint: null,
+ tasks: [],
+ };
+}
diff --git a/frontend/tests/unit/core/auth/server.test.ts b/frontend/tests/unit/core/auth/server.test.ts
new file mode 100644
index 000000000..fea6ef830
--- /dev/null
+++ b/frontend/tests/unit/core/auth/server.test.ts
@@ -0,0 +1,77 @@
+import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
+
+import { STATIC_WEBSITE_USER } from "@/core/auth/static-user";
+
+vi.mock("next/headers", () => ({
+ cookies: vi.fn(() => {
+ throw new Error("cookies should not be read in static website mode");
+ }),
+}));
+
+const ENV_KEYS = [
+ "DEER_FLOW_AUTH_DISABLED",
+ "NEXT_PUBLIC_STATIC_WEBSITE_ONLY",
+] as const;
+
+type EnvSnapshot = Partial<
+ Record<(typeof ENV_KEYS)[number], string | undefined>
+>;
+
+function snapshotEnv(): EnvSnapshot {
+ const snapshot: EnvSnapshot = {};
+ for (const key of ENV_KEYS) {
+ snapshot[key] = process.env[key];
+ }
+ return snapshot;
+}
+
+function setEnv(key: (typeof ENV_KEYS)[number], value: string | undefined) {
+ const env = process.env as Record;
+ if (value === undefined) {
+ delete env[key];
+ } else {
+ env[key] = value;
+ }
+}
+
+function restoreEnv(snapshot: EnvSnapshot) {
+ for (const key of ENV_KEYS) {
+ setEnv(key, snapshot[key]);
+ }
+}
+
+async function loadFreshServerAuth() {
+ vi.resetModules();
+ return await import("@/core/auth/server");
+}
+
+describe("getServerSideUser", () => {
+ let saved: EnvSnapshot;
+
+ beforeEach(() => {
+ saved = snapshotEnv();
+ setEnv("DEER_FLOW_AUTH_DISABLED", undefined);
+ setEnv("NEXT_PUBLIC_STATIC_WEBSITE_ONLY", undefined);
+ });
+
+ afterEach(() => {
+ restoreEnv(saved);
+ vi.unstubAllGlobals();
+ });
+
+ test("bypasses gateway auth in static website mode", async () => {
+ setEnv("NEXT_PUBLIC_STATIC_WEBSITE_ONLY", "true");
+ const fetchSpy = vi.fn(() => {
+ throw new Error("fetch should not be called in static website mode");
+ });
+ vi.stubGlobal("fetch", fetchSpy);
+
+ const { getServerSideUser } = await loadFreshServerAuth();
+
+ await expect(getServerSideUser()).resolves.toEqual({
+ tag: "authenticated",
+ user: STATIC_WEBSITE_USER,
+ });
+ expect(fetchSpy).not.toHaveBeenCalled();
+ });
+});