@lobehub/lobehub 2.0.0-next.144 → 2.0.0-next.146

package/.cursor/rules/project-introduce.mdc

@@ -4,7 +4,7 @@ alwaysApply: true
 
 ## Project Description
 
-You are developing an open-source, modern-design AI chat framework: lobehub(previous lobe-chat).
+You are developing an open-source, modern-design AI Agent Workspace: LobeHub(previous LobeChat).
 
 Supported platforms:
 

package/.github/workflows/test.yml

@@ -145,6 +145,9 @@ jobs:
         env:
           NODE_OPTIONS: --max-old-space-size=6144
 
+      - name: Typecheck Desktop
+        run: pnpm typecheck
+        working-directory: apps/desktop
 
       - name: Test Desktop Client
         run: pnpm test

package/AGENTS.md

@@ -2,6 +2,10 @@
 
 This document serves as a comprehensive guide for all team members when developing LobeChat.
 
+## Project Description
+
+You are developing an open-source, modern-design AI Agent Workspace: LobeHub(previous LobeChat).
+
 ## Tech Stack
 
 Built with modern technologies:

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 # Changelog
 
+## [Version 2.0.0-next.146](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.145...v2.0.0-next.146)
+
+<sup>Released on **2025-12-02**</sup>
+
+#### ♻ Code Refactoring
+
+- **misc**: Refactor agent slug schema.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Code refactoring
+
+- **misc**: Refactor agent slug schema, closes [#10561](https://github.com/lobehub/lobe-chat/issues/10561) ([0d609d1](https://github.com/lobehub/lobe-chat/commit/0d609d1))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+## [Version 2.0.0-next.145](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.144...v2.0.0-next.145)
+
+<sup>Released on **2025-12-02**</sup>
+
+#### ✨ Features
+
+- **misc**: Email provider support resend.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's improved
+
+- **misc**: Email provider support resend, closes [#10557](https://github.com/lobehub/lobe-chat/issues/10557) ([7449b29](https://github.com/lobehub/lobe-chat/commit/7449b29))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.144](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.143...v2.0.0-next.144)
 
 <sup>Released on **2025-12-02**</sup>

package/apps/desktop/package.json

@@ -65,6 +65,7 @@
     "happy-dom": "^20.0.11",
     "http-proxy-agent": "^7.0.2",
     "https-proxy-agent": "^7.0.6",
+    "i18next": "^25.6.3",
     "just-diff": "^6.0.2",
     "lodash": "^4.17.21",
     "lodash-es": "^4.17.21",
@@ -74,6 +75,7 @@
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
     "undici": "^7.16.0",
+    "uuid": "^13.0.0",
     "vite": "^7.2.4",
     "vitest": "^3.2.4"
   },

package/apps/desktop/src/main/controllers/__tests__/UploadFileCtr.test.ts

@@ -34,10 +34,9 @@ describe('UploadFileCtr', () => {
       const params = {
         hash: 'abc123',
         path: '/test/file.txt',
-        dataType: 'base64' as const,
-        data: 'dGVzdCBjb250ZW50',
+        content: new ArrayBuffer(16),
         filename: 'file.txt',
-        fileType: 'txt',
+        type: 'text/plain',
       };
       const expectedResult = { id: 'file-id-123', url: '/files/file-id-123' };
       mockFileService.uploadFile.mockResolvedValue(expectedResult);
@@ -52,10 +51,9 @@ describe('UploadFileCtr', () => {
       const params = {
         hash: 'abc123',
         path: '/test/file.txt',
-        dataType: 'base64' as const,
-        data: 'dGVzdCBjb250ZW50',
+        content: new ArrayBuffer(16),
         filename: 'file.txt',
-        fileType: 'txt',
+        type: 'text/plain',
       };
       const error = new Error('Upload failed');
       mockFileService.uploadFile.mockRejectedValue(error);
@@ -139,10 +137,9 @@ describe('UploadFileCtr', () => {
       const params = {
         hash: 'xyz789',
         path: '/test/newfile.txt',
-        dataType: 'base64' as const,
-        data: 'bmV3IGZpbGUgY29udGVudA==',
+        content: 'bmV3IGZpbGUgY29udGVudA==',
         filename: 'newfile.txt',
-        fileType: 'txt',
+        type: 'text/plain',
       };
       const expectedResult = { id: 'new-file-id', url: '/files/new-file-id' };
       mockFileService.uploadFile.mockResolvedValue(expectedResult);
@@ -157,10 +154,9 @@ describe('UploadFileCtr', () => {
       const params = {
         hash: 'xyz789',
         path: '/test/newfile.txt',
-        dataType: 'base64' as const,
-        data: 'bmV3IGZpbGUgY29udGVudA==',
+        content: 'bmV3IGZpbGUgY29udGVudA==',
         filename: 'newfile.txt',
-        fileType: 'txt',
+        type: 'text/plain',
       };
       const error = new Error('Create failed');
       mockFileService.uploadFile.mockRejectedValue(error);

package/apps/desktop/src/main/core/infrastructure/__tests__/ProtocolManager.test.ts

@@ -315,6 +315,7 @@ describe('ProtocolManager', () => {
     it('should show main window and dispatch to handler', async () => {
       vi.mocked(parseProtocolUrl).mockReturnValue({
         action: 'install',
+        originalUrl: 'lobehub://plugin/install?url=https://example.com',
         params: { url: 'https://example.com' },
         urlType: 'plugin',
       });

package/apps/desktop/src/main/core/ui/__tests__/Tray.test.ts

@@ -242,7 +242,7 @@ describe('Tray', () => {
       const templateArg = vi.mocked(Menu.buildFromTemplate).mock.calls[0][0];
       const showMainWindowItem = templateArg.find((item: any) => item.label === 'Show Main Window');
 
-      showMainWindowItem?.click?.();
+      showMainWindowItem?.click?.(null as any, null as any, null as any);
 
       expect(mockApp.browserManager.showMainWindow).toHaveBeenCalled();
     });
@@ -253,7 +253,7 @@ describe('Tray', () => {
       const templateArg = vi.mocked(Menu.buildFromTemplate).mock.calls[0][0];
       const quitItem = templateArg.find((item: any) => item.label === 'Quit');
 
-      quitItem?.click?.();
+      quitItem?.click?.(null as any, null as any, null as any);
 
       expect(app.quit).toHaveBeenCalled();
     });

package/apps/desktop/src/main/utils/__tests__/file-system.test.ts

@@ -81,7 +81,7 @@ describe('file-system', () => {
       vi.mocked(statSync).mockImplementation(() => {
         throw new Error('ENOENT: no such file or directory');
       });
-      vi.mocked(mkdirSync).mockImplementation(() => {});
+      vi.mocked(mkdirSync).mockImplementation(() => undefined);
 
       makeSureDirExist(dir);
 

package/apps/desktop/src/main/utils/__tests__/logger.test.ts

@@ -27,7 +27,7 @@ describe('logger', () => {
   });
 
   afterEach(() => {
-    delete process.env.NODE_ENV;
+    delete (process.env as NodeJS.ProcessEnv & { NODE_ENV?: string }).NODE_ENV;
     delete process.env.DEBUG_VERBOSE;
   });
 
@@ -73,7 +73,7 @@ describe('logger', () => {
 
   describe('logger.error', () => {
     it('should use electronLog.error in production', () => {
-      process.env.NODE_ENV = 'production';
+      (process.env as NodeJS.ProcessEnv & { NODE_ENV?: string }).NODE_ENV = 'production';
       const logger = createLogger('test:error');
       logger.error('error message', { error: 'details' });
 
@@ -82,7 +82,7 @@ describe('logger', () => {
     });
 
     it('should use console.error in development', () => {
-      process.env.NODE_ENV = 'development';
+      (process.env as NodeJS.ProcessEnv & { NODE_ENV?: string }).NODE_ENV = 'development';
       const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
       const logger = createLogger('test:error');
       logger.error('error message', { error: 'details' });
@@ -107,7 +107,7 @@ describe('logger', () => {
 
   describe('logger.info', () => {
     it('should use electronLog.info with namespace in production', () => {
-      process.env.NODE_ENV = 'production';
+      (process.env as NodeJS.ProcessEnv & { NODE_ENV?: string }).NODE_ENV = 'production';
       const logger = createLogger('test:info');
       logger.info('info message', { data: 'value' });
 
@@ -118,7 +118,7 @@ describe('logger', () => {
     });
 
     it('should use debug logger in development', () => {
-      process.env.NODE_ENV = 'development';
+      (process.env as NodeJS.ProcessEnv & { NODE_ENV?: string }).NODE_ENV = 'development';
       const logger = createLogger('test:info');
       logger.info('info message', { data: 'value' });
 
@@ -162,7 +162,7 @@ describe('logger', () => {
 
   describe('logger.warn', () => {
     it('should use electronLog.warn in production', () => {
-      process.env.NODE_ENV = 'production';
+      (process.env as NodeJS.ProcessEnv & { NODE_ENV?: string }).NODE_ENV = 'production';
       const logger = createLogger('test:warn');
       logger.warn('warn message', { warning: 'details' });
 
@@ -171,7 +171,7 @@ describe('logger', () => {
     });
 
     it('should not use electronLog.warn in development', () => {
-      process.env.NODE_ENV = 'development';
+      (process.env as NodeJS.ProcessEnv & { NODE_ENV?: string }).NODE_ENV = 'development';
       const logger = createLogger('test:warn');
       logger.warn('warn message');
 

package/apps/desktop/src/main/utils/next-electron-rsc.ts

@@ -1,7 +1,9 @@
 // copy from https://github.com/kirill-konshin/next-electron-rsc
 import { serialize as serializeCookie } from 'cookie';
 import { type Protocol, type Session } from 'electron';
+// @ts-ignore
 import type { NextConfig } from 'next';
+// @ts-ignore
 import type NextNodeServer from 'next/dist/server/next-server';
 import assert from 'node:assert';
 import { IncomingMessage, ServerResponse } from 'node:http';
@@ -204,7 +206,7 @@ export function createHandler({
     logger.info('Initializing Next.js app for production');
 
     // https://github.com/lobehub/lobe-chat/pull/9851
-    // @ts-expect-error
+    // @ts-ignore
     // noinspection JSConstantReassignment
     process.env.NODE_ENV = 'production';
     const next = require(resolve.sync('next', { basedir: standaloneDir }));

package/apps/desktop/src/preload/invoke.test.ts

@@ -47,7 +47,8 @@ describe('invoke', () => {
     const expectedResult = { processed: true };
     mockIpcRendererInvoke.mockResolvedValue(expectedResult);
 
-    const result = await invoke('someEvent' as ClientDispatchEventKey, param1, param2, param3);
+    // Use 'as any' to bypass type checking for testing multiple parameters
+    const result = await (invoke as any)('someEvent', param1, param2, param3);
 
     expect(mockIpcRendererInvoke).toHaveBeenCalledWith('someEvent', param1, param2, param3);
     expect(mockIpcRendererInvoke).toHaveBeenCalledTimes(1);
@@ -109,7 +110,8 @@ describe('invoke', () => {
     const expectedResponse: TestResponse = { message: 'success', status: 200 };
     mockIpcRendererInvoke.mockResolvedValue(expectedResponse);
 
-    const result = await invoke('testEvent' as ClientDispatchEventKey);
+    // Use 'as any' to bypass type checking for testing with mock event
+    const result = (await (invoke as any)('testEvent')) as TestResponse;
 
     expect(result).toEqual(expectedResponse);
     expect(typeof result.message).toBe('string');

package/apps/desktop/src/preload/routeInterceptor.test.ts

@@ -110,7 +110,12 @@ describe('setupRouteInterceptors', () => {
     it('should intercept internal link matching route pattern', async () => {
       setupRouteInterceptors();
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       const link = document.createElement('a');
@@ -142,7 +147,12 @@ describe('setupRouteInterceptors', () => {
         pathname: '/desktop/devtools/console',
       });
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       const link = document.createElement('a');
@@ -183,7 +193,12 @@ describe('setupRouteInterceptors', () => {
     it('should intercept pushState for matched routes', () => {
       setupRouteInterceptors();
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       const originalLength = history.length;
@@ -208,7 +223,12 @@ describe('setupRouteInterceptors', () => {
         pathname: '/desktop/devtools/console',
       });
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       history.pushState({}, '', '/desktop/devtools/network');
@@ -248,7 +268,12 @@ describe('setupRouteInterceptors', () => {
     it('should intercept replaceState for matched routes', () => {
       setupRouteInterceptors();
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       history.replaceState({}, '', '/desktop/devtools');
@@ -270,7 +295,12 @@ describe('setupRouteInterceptors', () => {
         pathname: '/desktop/devtools/console',
       });
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       history.replaceState({}, '', '/desktop/devtools/network');
@@ -296,7 +326,12 @@ describe('setupRouteInterceptors', () => {
       setupRouteInterceptors();
 
       // First trigger a route interception to add path to preventedPaths
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
       history.pushState({}, '', '/desktop/devtools');
 
@@ -338,7 +373,12 @@ describe('setupRouteInterceptors', () => {
 
       setupRouteInterceptors();
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       history.pushState({}, '', '/desktop/devtools');
@@ -358,7 +398,12 @@ describe('setupRouteInterceptors', () => {
 
       setupRouteInterceptors();
 
-      const matchedRoute = { pathPrefix: '/desktop/devtools', targetWindow: 'devtools' };
+      const matchedRoute = {
+        description: 'Developer Tools',
+        enabled: true,
+        pathPrefix: '/desktop/devtools',
+        targetWindow: 'devtools',
+      };
       vi.mocked(findMatchingRoute).mockReturnValue(matchedRoute);
 
       history.pushState({}, '', '/desktop/devtools');

package/apps/desktop/src/preload/streamer.test.ts

@@ -30,9 +30,9 @@ describe('onStreamInvoke', () => {
 
   it('should set up stream listeners and send start event', () => {
     const params: ProxyTRPCRequestParams = {
-      input: { query: 'test' },
-      path: 'test.endpoint',
-      type: 'query',
+      headers: { 'content-type': 'application/json' },
+      method: 'POST',
+      urlPath: '/trpc/lambda/test.endpoint',
     };
 
     const callbacks = {
@@ -78,9 +78,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     onStreamInvoke(params, callbacks);
@@ -106,9 +106,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     onStreamInvoke(params, callbacks);
@@ -138,9 +138,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     onStreamInvoke(params, callbacks);
@@ -179,9 +179,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     onStreamInvoke(params, callbacks);
@@ -221,9 +221,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     const cleanup = onStreamInvoke(params, callbacks);
@@ -255,9 +255,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     onStreamInvoke(params, callbacks);
@@ -290,13 +290,14 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {
+      body: JSON.stringify({
         filters: { active: true },
         query: 'complex query',
         sort: { field: 'date', order: 'desc' },
-      },
-      path: 'complex.nested.endpoint',
-      type: 'mutation',
+      }),
+      headers: { 'content-type': 'application/json', 'x-custom-header': 'value' },
+      method: 'POST',
+      urlPath: '/trpc/lambda/complex.nested.endpoint',
     };
 
     onStreamInvoke(params, callbacks);
@@ -316,9 +317,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     const cleanup = onStreamInvoke(params, callbacks);
@@ -346,9 +347,9 @@ describe('onStreamInvoke', () => {
     };
 
     const params: ProxyTRPCRequestParams = {
-      input: {},
-      path: 'test',
-      type: 'query',
+      headers: {},
+      method: 'GET',
+      urlPath: '/trpc/test',
     };
 
     onStreamInvoke(params, callbacks);

package/changelog/v1.json

@@ -1,4 +1,22 @@
 [
+  {
+    "children": {
+      "improvements": [
+        "Refactor agent slug schema."
+      ]
+    },
+    "date": "2025-12-02",
+    "version": "2.0.0-next.146"
+  },
+  {
+    "children": {
+      "features": [
+        "Email provider support resend."
+      ]
+    },
+    "date": "2025-12-02",
+    "version": "2.0.0-next.145"
+  },
   {
     "children": {
       "fixes": [

package/docs/development/database-schema.dbml

@@ -1,6 +1,6 @@
 table agents {
   id text [pk, not null]
-  slug varchar(100) [unique]
+  slug varchar(100)
   title varchar(255)
   description varchar(1000)
   tags jsonb [default: `[]`]
@@ -27,6 +27,7 @@ table agents {
 
   indexes {
     (client_id, user_id) [name: 'client_id_user_id_unique', unique]
+    (slug, user_id) [name: 'agents_slug_user_id_unique', unique]
     title [name: 'agents_title_idx']
     description [name: 'agents_description_idx']
   }

package/docs/self-hosting/advanced/auth.mdx

@@ -89,16 +89,27 @@ When configuring OAuth providers, use the following callback URL format:
 
 ### Email Service Configuration
 
-If you want to enable email verification or password reset features, you need to configure SMTP settings:
-
-| Environment Variable                  | Type     | Description                                                       |
-| ------------------------------------- | -------- | ----------------------------------------------------------------- |
-| `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION` | Optional | Set to `1` to require email verification before users can sign in |
-| `SMTP_HOST`                           | Required | SMTP server hostname (e.g., `smtp.gmail.com`)                     |
-| `SMTP_PORT`                           | Required | SMTP server port (usually `587` for TLS, `465` for SSL)           |
-| `SMTP_SECURE`                         | Optional | Set to `true` for SSL (port 465), `false` for TLS (port 587)      |
-| `SMTP_USER`                           | Required | SMTP authentication username                                      |
-| `SMTP_PASS`                           | Required | SMTP authentication password                                      |
+Used by email verification, password reset, and magic-link delivery. Choose a provider, then fill the matching variables:
+
+| Environment Variable                  | Type        | Description                                                                                                                                       |
+| ------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION` | Optional    | Set to `1` to require email verification before users can sign in                                                                                 |
+| `EMAIL_SERVICE_PROVIDER`              | Optional    | Email provider selector: `nodemailer` (default, SMTP) or `resend`                                                                                 |
+| `SMTP_HOST`                           | Required    | SMTP server hostname (e.g., `smtp.gmail.com`). Used when `EMAIL_SERVICE_PROVIDER=nodemailer`                                                      |
+| `SMTP_PORT`                           | Required    | SMTP server port (usually `587` for TLS, `465` for SSL). Used when `EMAIL_SERVICE_PROVIDER=nodemailer`                                            |
+| `SMTP_SECURE`                         | Optional    | `true` for SSL (port 465), `false` for TLS (port 587). Used when `EMAIL_SERVICE_PROVIDER=nodemailer`                                              |
+| `SMTP_USER`                           | Required    | SMTP auth username. Used when `EMAIL_SERVICE_PROVIDER=nodemailer`                                                                                 |
+| `SMTP_PASS`                           | Required    | SMTP auth password. Used when `EMAIL_SERVICE_PROVIDER=nodemailer`                                                                                 |
+| `RESEND_API_KEY`                      | Required    | Resend API key. Required when `EMAIL_SERVICE_PROVIDER=resend`                                                                                     |
+| `RESEND_FROM`                         | Recommended | Default sender address (e.g., `noreply@your-verified-domain.com`). Must be a domain verified in Resend. Used when `EMAIL_SERVICE_PROVIDER=resend` |
+
+### Magic Link (Passwordless) Login
+
+Enable BetterAuth magic-link login (depends on a working email provider above):
+
+| Environment Variable            | Type     | Description                                        |
+| ------------------------------- | -------- | -------------------------------------------------- |
+| `NEXT_PUBLIC_ENABLE_MAGIC_LINK` | Optional | Set to `1` to enable passwordless magic-link login |
 
 <Callout type={'tip'}>
   For detailed provider configuration, refer to the [Next Auth provider documentation](/docs/self-hosting/advanced/auth/next-auth) as most configurations are compatible, or visit the official [Better Auth documentation](https://www.better-auth.com/docs/introduction).