@lobehub/lobehub 2.0.0-next.143 → 2.0.0-next.145

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/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.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>
+
+#### 🐛 Bug Fixes
+
+- **misc**: User email unique migration error.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: User email unique migration error, closes [#10548](https://github.com/lobehub/lobe-chat/issues/10548) ([ca2a1a2](https://github.com/lobehub/lobe-chat/commit/ca2a1a2))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.143](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.142...v2.0.0-next.143)
 
 <sup>Released on **2025-12-02**</sup>

package/changelog/v1.json

@@ -1,4 +1,22 @@
 [
+  {
+    "children": {
+      "features": [
+        "Email provider support resend."
+      ]
+    },
+    "date": "2025-12-02",
+    "version": "2.0.0-next.145"
+  },
+  {
+    "children": {
+      "fixes": [
+        "User email unique migration error."
+      ]
+    },
+    "date": "2025-12-02",
+    "version": "2.0.0-next.144"
+  },
   {
     "children": {
       "features": [

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).

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

@@ -87,16 +87,27 @@ LobeChat 与 Clerk 做了深度集成，能够为用户提供一个更加安全
 
 ### 邮件服务配置
 
-如果需要启用邮箱验证或密码重置功能，需要配置 SMTP 设置：
-
-| 环境变量                                  | 类型 | 描述                                             |
-| ------------------------------------- | -- | ---------------------------------------------- |
-| `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION` | 可选 | 设置为 `1` 以要求用户在登录前验证邮箱                          |
-| `SMTP_HOST`                           | 必选 | SMTP 服务器主机名（例如 `smtp.gmail.com`）               |
-| `SMTP_PORT`                           | 必选 | SMTP 服务器端口（TLS 通常为 `587`，SSL 为 `465`）          |
-| `SMTP_SECURE`                         | 可选 | SSL 设置为 `true`（端口 465），TLS 设置为 `false`（端口 587） |
-| `SMTP_USER`                           | 必选 | SMTP 认证用户名                                     |
-| `SMTP_PASS`                           | 必选 | SMTP 认证密码                                      |
+用于邮箱验证、密码重置和魔法链接发送。先选择邮件服务，再填对应变量：
+
+| 环境变量                                  | 类型 | 描述                                                                                        |
+| ------------------------------------- | -- | ----------------------------------------------------------------------------------------- |
+| `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION` | 可选 | 设置为 `1` 以要求用户在登录前验证邮箱                                                                     |
+| `EMAIL_SERVICE_PROVIDER`              | 可选 | 邮件服务选择：`nodemailer`（默认，SMTP）或 `resend`                                                    |
+| `SMTP_HOST`                           | 必选 | SMTP 服务器主机名（如 `smtp.gmail.com`），仅在 `EMAIL_SERVICE_PROVIDER=nodemailer` 时需要                |
+| `SMTP_PORT`                           | 必选 | SMTP 服务器端口（TLS 通常为 `587`，SSL 为 `465`），仅在 `EMAIL_SERVICE_PROVIDER=nodemailer` 时需要          |
+| `SMTP_SECURE`                         | 可选 | SSL 设置为 `true`（端口 465），TLS 设置为 `false`（端口 587），仅在 `EMAIL_SERVICE_PROVIDER=nodemailer` 时需要 |
+| `SMTP_USER`                           | 必选 | SMTP 认证用户名，仅在 `EMAIL_SERVICE_PROVIDER=nodemailer` 时需要                                     |
+| `SMTP_PASS`                           | 必选 | SMTP 认证密码，仅在 `EMAIL_SERVICE_PROVIDER=nodemailer` 时需要                                      |
+| `RESEND_API_KEY`                      | 必选 | Resend API Key，`EMAIL_SERVICE_PROVIDER=resend` 时必填                                        |
+| `RESEND_FROM`                         | 推荐 | 默认发件人地址（如 `noreply@已验证域名`），需为 Resend 已验证域名下的邮箱，`EMAIL_SERVICE_PROVIDER=resend` 时使用        |
+
+### 魔法链接（免密）登录
+
+启用 BetterAuth 魔法链接登录（依赖上方已配置好的邮件服务）：
+
+| 环境变量                            | 类型 | 描述                |
+| ------------------------------- | -- | ----------------- |
+| `NEXT_PUBLIC_ENABLE_MAGIC_LINK` | 可选 | 设置为 `1` 以启用魔法链接登录 |
 
 <Callout type={'tip'}>
   详细的提供商配置可参考 [Next Auth 提供商文档](/zh/docs/self-hosting/advanced/auth/next-auth)（大部分配置兼容），或访问官方 [Better Auth 文档](https://www.better-auth.com/docs/introduction)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.143",
+  "version": "2.0.0-next.145",
   "description": "LobeHub - an open-source,comprehensive AI Agent framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",
@@ -285,6 +285,7 @@
     "remark": "^15.0.1",
     "remark-gfm": "^4.0.1",
     "remark-html": "^16.0.1",
+    "resend": "^6.5.2",
     "resolve-accept-language": "^3.1.15",
     "rtl-detect": "^1.1.2",
     "semver": "^7.7.3",

package/packages/database/migrations/0054_better_auth_two_factor.sql

@@ -35,6 +35,8 @@ CREATE INDEX IF NOT EXISTS "verification_identifier_idx" ON "verifications" USIN
 DO $$
 BEGIN
   IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'users_email_unique') THEN
+    -- Normalize empty emails so the unique constraint can be created safely
+    UPDATE "users" SET "email" = NULL WHERE "email" = '';
     ALTER TABLE "users" ADD CONSTRAINT "users_email_unique" UNIQUE ("email");
   END IF;
 END $$;

package/packages/database/src/core/migrations.json

@@ -884,7 +884,7 @@
       "\nCREATE INDEX IF NOT EXISTS \"account_userId_idx\" ON \"accounts\" USING btree (\"user_id\");\n",
       "\nCREATE INDEX IF NOT EXISTS \"auth_session_userId_idx\" ON \"auth_sessions\" USING btree (\"user_id\");\n",
       "\nCREATE INDEX IF NOT EXISTS \"verification_identifier_idx\" ON \"verifications\" USING btree (\"identifier\");\n",
-      "\nDO $$\nBEGIN\n  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'users_email_unique') THEN\n    ALTER TABLE \"users\" ADD CONSTRAINT \"users_email_unique\" UNIQUE (\"email\");\n  END IF;\nEND $$;\n",
+      "\nDO $$\nBEGIN\n  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'users_email_unique') THEN\n    UPDATE \"users\" SET \"email\" = NULL WHERE \"email\" = '';\n    ALTER TABLE \"users\" ADD CONSTRAINT \"users_email_unique\" UNIQUE (\"email\");\n  END IF;\nEND $$;\n",
       "\nDO $$\nBEGIN\n  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'users_phone_number_unique') THEN\n    ALTER TABLE \"users\" ADD CONSTRAINT \"users_phone_number_unique\" UNIQUE (\"phone_number\");\n  END IF;\nEND $$;\n"
     ],
     "bps": true,

package/packages/database/src/models/user.ts

@@ -149,9 +149,11 @@ export class UserModel {
   };
 
   updateUser = async (value: Partial<UserItem>) => {
+    const nextValue = UserModel.normalizeUniqueUserFields(value);
+
     return this.db
       .update(users)
-      .set({ ...value, updatedAt: new Date() })
+      .set({ ...nextValue, updatedAt: new Date() })
       .where(eq(users.id, this.userId));
   };
 
@@ -193,6 +195,26 @@ export class UserModel {
       .where(eq(users.id, this.userId));
   };
 
+  /**
+   * Normalize unique user fields so empty strings become null, keeping unique constraints safe.
+   */
+  private static normalizeUniqueUserFields = <
+    T extends { email?: string | null; phone?: string | null },
+  >(
+    value: T,
+  ) => {
+    const normalizedEmail =
+      typeof value.email === 'string' && value.email.trim() === '' ? null : value.email;
+    const normalizedPhone =
+      typeof value.phone === 'string' && value.phone.trim() === '' ? null : value.phone;
+
+    return {
+      ...value,
+      ...(value.email !== undefined ? { email: normalizedEmail } : {}),
+      ...(value.phone !== undefined ? { phone: normalizedPhone } : {}),
+    };
+  };
+
   // Static method
   static makeSureUserExist = async (db: LobeChatDatabase, userId: string) => {
     await db.insert(users).values({ id: userId }).onConflictDoNothing();
@@ -205,10 +227,8 @@ export class UserModel {
       if (!!user) return { duplicate: true };
     }
 
-    const [user] = await db
-      .insert(users)
-      .values({ ...params })
-      .returning();
+    const normalizedParams = this.normalizeUniqueUserFields(params);
+    const [user] = await db.insert(users).values(normalizedParams).returning();
 
     return { duplicate: false, user };
   };

package/scripts/migrateServerDB/errorHint.js

@@ -24,7 +24,33 @@ DATABASE_DRIVER=node
 if you have any other question, please open issue here: https://github.com/lobehub/lobe-chat/issues
 `;
 
+const DUPLICATE_EMAIL_HINT = `------------------------------------------------------------------------------------------
+⚠️ Database migration failed due to duplicate email addresses in the users table.
+
+The database schema requires each email to be unique, but multiple users currently share the same email value.
+
+Recommended solutions (choose one and rerun the migration):
+
+1) Update duplicate emails to make them unique: change the conflicting email addresses to another unique email address or just change them email to NULL
+2) Remove duplicate user records (dangerously, only if safe to delete)
+
+⚠️ IMPORTANT: Always backup your database before making any changes!
+
+To find duplicate emails, run this query:
+
+\`\`\`sql
+SELECT email, COUNT(*) as count
+FROM users
+WHERE email IS NOT NULL
+GROUP BY email
+HAVING COUNT(*) > 1;
+\`\`\`
+
+If you need further assistance, please open an issue: https://github.com/lobehub/lobe-chat/issues
+`;
+
 module.exports = {
   DB_FAIL_INIT_HINT,
+  DUPLICATE_EMAIL_HINT,
   PGVECTOR_HINT,
 };

package/scripts/migrateServerDB/index.ts

@@ -4,7 +4,7 @@ import { migrate as nodeMigrate } from 'drizzle-orm/node-postgres/migrator';
 import { join } from 'node:path';
 
 // @ts-ignore tsgo handle esm import cjs and compatibility issues
-import { DB_FAIL_INIT_HINT, PGVECTOR_HINT } from './errorHint';
+import { DB_FAIL_INIT_HINT, DUPLICATE_EMAIL_HINT, PGVECTOR_HINT } from './errorHint';
 
 // Read the `.env` file if it exists, or a file specified by the
 // dotenv_config_path parameter that's passed to Node.js
@@ -39,8 +39,12 @@ if (!isDesktop && connectionString) {
 
     const errMsg = err.message as string;
 
+    const constraint = (err as { constraint?: string })?.constraint;
+
     if (errMsg.includes('extension "vector" is not available')) {
       console.info(PGVECTOR_HINT);
+    } else if (constraint === 'users_email_unique' || errMsg.includes('users_email_unique')) {
+      console.info(DUPLICATE_EMAIL_HINT);
     } else if (errMsg.includes(`Cannot read properties of undefined (reading 'migrate')`)) {
       console.info(DB_FAIL_INIT_HINT);
     }

package/src/envs/email.ts

@@ -6,6 +6,9 @@ declare global {
   // eslint-disable-next-line @typescript-eslint/no-namespace
   namespace NodeJS {
     interface ProcessEnv {
+      EMAIL_SERVICE_PROVIDER?: string;
+      RESEND_API_KEY?: string;
+      RESEND_FROM?: string;
       SMTP_HOST?: string;
       SMTP_PASS?: string;
       SMTP_PORT?: string;
@@ -18,6 +21,9 @@ declare global {
 export const getEmailConfig = () => {
   return createEnv({
     server: {
+      EMAIL_SERVICE_PROVIDER: z.enum(['nodemailer', 'resend']).optional(),
+      RESEND_API_KEY: z.string().optional(),
+      RESEND_FROM: z.string().optional(),
       SMTP_HOST: z.string().optional(),
       SMTP_PORT: z.coerce.number().optional(),
       SMTP_SECURE: z.boolean().optional(),
@@ -30,6 +36,11 @@ export const getEmailConfig = () => {
       SMTP_SECURE: process.env.SMTP_SECURE === 'true',
       SMTP_USER: process.env.SMTP_USER,
       SMTP_PASS: process.env.SMTP_PASS,
+      EMAIL_SERVICE_PROVIDER: process.env.EMAIL_SERVICE_PROVIDER
+        ? process.env.EMAIL_SERVICE_PROVIDER.toLowerCase()
+        : undefined,
+      RESEND_API_KEY: process.env.RESEND_API_KEY,
+      RESEND_FROM: process.env.RESEND_FROM,
     },
   });
 };

package/src/libs/better-auth/email-templates/magic-link.ts

@@ -18,7 +18,7 @@ export const getMagicLinkEmailTemplate = (params: { expiresInSeconds: number; ur
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Sign in to LobeChat</title>
+  <title>Sign in to LobeHub</title>
 </head>
 <body style="margin: 0; padding: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif; background-color: #f4f4f5; color: #1a1a1a;">
   <!-- Container -->
@@ -28,7 +28,7 @@ export const getMagicLinkEmailTemplate = (params: { expiresInSeconds: number; ur
     <div style="text-align: center; margin-bottom: 32px;">
       <div style="display: inline-flex; align-items: center; justify-content: center; background-color: #ffffff; border-radius: 12px; padding: 8px 16px; box-shadow: 0 2px 8px rgba(0,0,0,0.04);">
         <span style="font-size: 24px; line-height: 1; margin-right: 10px;">🤯</span>
-        <span style="font-size: 18px; font-weight: 700; color: #000000; letter-spacing: -0.5px;">LobeChat</span>
+        <span style="font-size: 18px; font-weight: 700; color: #000000; letter-spacing: -0.5px;">LobeHub</span>
       </div>
     </div>
 
@@ -38,7 +38,7 @@ export const getMagicLinkEmailTemplate = (params: { expiresInSeconds: number; ur
       <!-- Header -->
       <div style="text-align: center; margin-bottom: 32px;">
         <h1 style="color: #111827; font-size: 24px; font-weight: 700; margin: 0 0 12px 0; letter-spacing: -0.5px;">
-          Sign in to LobeChat
+          Sign in to LobeHub
         </h1>
         <p style="color: #6b7280; font-size: 16px; margin: 0; line-height: 1.5;">
           Click the link below to sign in to your account.
@@ -85,14 +85,14 @@ export const getMagicLinkEmailTemplate = (params: { expiresInSeconds: number; ur
     <!-- Footer -->
     <div style="text-align: center; margin-top: 32px;">
       <p style="color: #a1a1aa; font-size: 13px; margin: 0;">
-        © ${new Date().getFullYear()} LobeChat. All rights reserved.
+        © ${new Date().getFullYear()} LobeHub. All rights reserved.
       </p>
     </div>
   </div>
 </body>
 </html>
     `,
-    subject: 'Your LobeChat sign-in link',
+    subject: 'Your LobeHub sign-in link',
     text: `Use this link to sign in: ${url}\n\nThis link expires in ${expirationText}.`,
   };
 };

package/src/libs/better-auth/email-templates/reset-password.ts

@@ -22,7 +22,7 @@ export const getResetPasswordEmailTemplate = (params: { url: string }) => {
     <div style="text-align: center; margin-bottom: 32px;">
       <div style="display: inline-flex; align-items: center; justify-content: center; background-color: #ffffff; border-radius: 12px; padding: 8px 16px; box-shadow: 0 2px 8px rgba(0,0,0,0.04);">
         <span style="font-size: 24px; line-height: 1; margin-right: 10px;">🤯</span>
-        <span style="font-size: 18px; font-weight: 700; color: #000000; letter-spacing: -0.5px;">LobeChat</span>
+        <span style="font-size: 18px; font-weight: 700; color: #000000; letter-spacing: -0.5px;">LobeHub</span>
       </div>
     </div>
 
@@ -42,7 +42,7 @@ export const getResetPasswordEmailTemplate = (params: { url: string }) => {
       <!-- Content -->
       <div style="color: #374151; font-size: 16px; line-height: 1.6;">
         <p style="margin: 0 0 24px 0; text-align: center;">
-          You recently requested to reset your password for your LobeChat account. Click the button below to proceed.
+          You recently requested to reset your password for your LobeHub account. Click the button below to proceed.
         </p>
 
         <!-- Button -->
@@ -78,14 +78,14 @@ export const getResetPasswordEmailTemplate = (params: { url: string }) => {
     <!-- Footer -->
     <div style="text-align: center; margin-top: 32px;">
       <p style="color: #a1a1aa; font-size: 13px; margin: 0;">
-        © ${new Date().getFullYear()} LobeChat. All rights reserved.
+        © ${new Date().getFullYear()} LobeHub. All rights reserved.
       </p>
     </div>
   </div>
 </body>
 </html>
     `,
-    subject: 'Reset Your Password - LobeChat',
+    subject: 'Reset Your Password - LobeHub',
     text: `Reset your password by clicking this link: ${url}`,
   };
 };

package/src/libs/better-auth/email-templates/verification.ts

@@ -33,7 +33,7 @@ export const getVerificationEmailTemplate = (params: {
     <div style="text-align: center; margin-bottom: 32px;">
       <div style="display: inline-flex; align-items: center; justify-content: center; background-color: #ffffff; border-radius: 12px; padding: 8px 16px; box-shadow: 0 2px 8px rgba(0,0,0,0.04);">
         <span style="font-size: 24px; line-height: 1; margin-right: 10px;">🤯</span>
-        <span style="font-size: 18px; font-weight: 700; color: #000000; letter-spacing: -0.5px;">LobeChat</span>
+        <span style="font-size: 18px; font-weight: 700; color: #000000; letter-spacing: -0.5px;">LobeHub</span>
       </div>
     </div>
 
@@ -55,7 +55,7 @@ export const getVerificationEmailTemplate = (params: {
         ${userName ? `<p style="margin: 0 0 16px 0;">Hi <strong>${userName}</strong>,</p>` : ''}
         
         <p style="margin: 0 0 24px 0;">
-          Thanks for creating an account with LobeChat. To access your account, please verify your email address by clicking the button below.
+          Thanks for creating an account with LobeHub. To access your account, please verify your email address by clicking the button below.
         </p>
 
         <!-- Button -->
@@ -95,14 +95,14 @@ export const getVerificationEmailTemplate = (params: {
     <!-- Footer -->
     <div style="text-align: center; margin-top: 32px;">
       <p style="color: #a1a1aa; font-size: 13px; margin: 0;">
-        © 2025 LobeChat. All rights reserved.
+        © 2025 LobeHub. All rights reserved.
       </p>
     </div>
   </div>
 </body>
 </html>
     `,
-    subject: 'Verify Your Email - LobeChat',
+    subject: 'Verify Your Email - LobeHub',
     text: `Please verify your email by clicking this link: ${url}\n\nThis link will expire in ${expirationText}.`,
   };
 };

package/src/server/services/email/README.md

@@ -86,6 +86,25 @@ SMTP_USER=your-username
 SMTP_PASS=your-password
 ```
 
+### Resend
+
+If you prefer Resend, configure the following and initialize the service with `EmailImplType.Resend`:
+
+```bash
+RESEND_API_KEY=your-resend-api-key
+RESEND_FROM=noreply@example.com
+```
+
+`RESEND_FROM` is used when `from` is not provided in the payload.
+
+### Choose Provider by Environment
+
+Set `EMAIL_SERVICE_PROVIDER` to `nodemailer` or `resend` to pick the default implementation without changing code:
+
+```bash
+EMAIL_SERVICE_PROVIDER=resend
+```
+
 ### Using Well-Known Services
 
 You can also use well-known email services (Gmail, SendGrid, etc.):

package/src/server/services/email/impls/index.ts

@@ -1,4 +1,5 @@
 import { NodemailerImpl } from './nodemailer';
+import { ResendImpl } from './resend';
 import { EmailServiceImpl } from './type';
 
 /**
@@ -6,8 +7,8 @@ import { EmailServiceImpl } from './type';
  */
 export enum EmailImplType {
   Nodemailer = 'nodemailer',
+  Resend = 'resend',
   // Future providers can be added here:
-  // Resend = 'resend',
   // SendGrid = 'sendgrid',
 }
 
@@ -21,6 +22,9 @@ export const createEmailServiceImpl = (
     case EmailImplType.Nodemailer: {
       return new NodemailerImpl();
     }
+    case EmailImplType.Resend: {
+      return new ResendImpl();
+    }
 
     default: {
       return new NodemailerImpl();

package/src/server/services/email/impls/resend/index.ts

@@ -0,0 +1,120 @@
+import { TRPCError } from '@trpc/server';
+import debug from 'debug';
+import { Resend } from 'resend';
+import type { CreateEmailOptions } from 'resend';
+
+import { emailEnv } from '@/envs/email';
+
+import { EmailPayload, EmailResponse, EmailServiceImpl } from '../type';
+
+const log = debug('lobe-email:Resend');
+
+/**
+ * Resend implementation of the email service
+ */
+export class ResendImpl implements EmailServiceImpl {
+  private client: Resend;
+
+  constructor() {
+    if (!emailEnv.RESEND_API_KEY) {
+      throw new Error(
+        'RESEND_API_KEY environment variable is required to use Resend email service. Please configure it in your .env file.',
+      );
+    }
+
+    this.client = new Resend(emailEnv.RESEND_API_KEY);
+    log('Initialized Resend client');
+  }
+
+  async sendMail(payload: EmailPayload): Promise<EmailResponse> {
+    const from = payload.from ?? emailEnv.RESEND_FROM;
+    const html = payload.html;
+    const text = payload.text;
+
+    if (!from) {
+      throw new TRPCError({
+        code: 'PRECONDITION_FAILED',
+        message: 'Missing sender address. Provide payload.from or RESEND_FROM environment variable.',
+      });
+    }
+
+    if (!html && !text) {
+      throw new TRPCError({
+        code: 'PRECONDITION_FAILED',
+        message: 'Resend requires either html or text content in the email payload.',
+      });
+    }
+
+    const attachments = payload.attachments?.map((attachment) => {
+      if (attachment.content instanceof Buffer) {
+        return {
+          ...attachment,
+          content: attachment.content.toString('base64'),
+        };
+      }
+
+      return attachment;
+    });
+
+    try {
+      log('Sending email via Resend: %o', {
+        from,
+        subject: payload.subject,
+        to: payload.to,
+      });
+
+      const emailOptions: CreateEmailOptions = html
+        ? {
+            attachments,
+            from,
+            html,
+            replyTo: payload.replyTo,
+            subject: payload.subject,
+            text,
+            to: payload.to,
+          }
+        : {
+            attachments,
+            from,
+            replyTo: payload.replyTo,
+            subject: payload.subject,
+            text: text!,
+            to: payload.to,
+          };
+
+      const { data, error } = await this.client.emails.send(emailOptions);
+
+      if (error) {
+        log.extend('error')('Failed to send email via Resend: %o', error);
+        throw new TRPCError({
+          cause: error,
+          code: 'SERVICE_UNAVAILABLE',
+          message: `Failed to send email via Resend: ${error.message}`,
+        });
+      }
+
+      if (!data?.id) {
+        log.extend('error')('Resend sendMail returned no message id: %o', data);
+        throw new TRPCError({
+          code: 'SERVICE_UNAVAILABLE',
+          message: 'Failed to send email via Resend: missing message id',
+        });
+      }
+
+      return {
+        messageId: data.id,
+      };
+    } catch (error) {
+      if (error instanceof TRPCError) {
+        throw error;
+      }
+
+      log.extend('error')('Unexpected Resend sendMail error: %o', error);
+      throw new TRPCError({
+        cause: error,
+        code: 'SERVICE_UNAVAILABLE',
+        message: `Failed to send email via Resend: ${(error as Error).message}`,
+      });
+    }
+  }
+}

package/src/server/services/email/index.test.ts

@@ -26,7 +26,7 @@ describe('EmailService', () => {
 
   describe('constructor', () => {
     it('should create instance with default email implementation', () => {
-      expect(createEmailServiceImpl).toHaveBeenCalledWith(undefined);
+      expect(createEmailServiceImpl).toHaveBeenCalledWith(EmailImplType.Nodemailer);
     });
 
     it('should create instance with specified implementation type', () => {

package/src/server/services/email/index.ts

@@ -1,3 +1,4 @@
+import { emailEnv } from '@/envs/email';
 
 import { EmailImplType, EmailPayload, EmailResponse, createEmailServiceImpl } from './impls';
 import type { EmailServiceImpl } from './impls';
@@ -10,7 +11,14 @@ export class EmailService {
   private emailImpl: EmailServiceImpl;
 
   constructor(implType?: EmailImplType) {
-    this.emailImpl = createEmailServiceImpl(implType);
+    // Avoid client-side access to server env when executed in browser-like test environments
+    const envImplType =
+      typeof window === 'undefined'
+        ? (emailEnv.EMAIL_SERVICE_PROVIDER as EmailImplType | undefined)
+        : undefined;
+    const resolvedImplType = implType ?? envImplType ?? EmailImplType.Nodemailer;
+
+    this.emailImpl = createEmailServiceImpl(resolvedImplType);
   }
 
   /**

package/src/server/services/file/impls/index.ts

@@ -5,11 +5,11 @@ import { S3StaticFileImpl } from './s3';
 import { FileServiceImpl } from './type';
 
 /**
- * 创建文件服务模块
- * 根据环境自动选择使用S3或桌面本地文件实现
+ * Create file service module
+ * Automatically selects between S3 or desktop local file implementation based on environment
  */
 export const createFileServiceModule = (): FileServiceImpl => {
-  // 如果在桌面应用环境，使用本地文件实现
+  // If in desktop application environment, use local file implementation
   if (isDesktop) {
     return new DesktopLocalFileImpl();
   }

package/src/server/services/file/impls/local.ts

@@ -12,12 +12,12 @@ import { extractKeyFromUrlOrReturnOriginal } from './utils';
 const log = debug('lobe-file:desktop-local');
 
 /**
- * 桌面应用本地文件服务实现
+ * Desktop application local file service implementation
  */
 export class DesktopLocalFileImpl implements FileServiceImpl {
   /**
-   * 获取本地文件的URL
-   * 通过 IPC 从主进程获取 HTTP URL
+   * Get local file URL
+   * Retrieve HTTP URL from main process via IPC
    */
   private async getLocalFileUrl(key: string): Promise<string> {
     try {
@@ -29,16 +29,16 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
   }
 
   /**
-   * 创建预签名上传URL（本地版实际上是直接返回文件路径，可能需要进一步扩展）
+   * Create pre-signed upload URL (local version directly returns file path, may need further extension)
    */
   async createPreSignedUrl(key: string): Promise<string> {
-    // 在桌面应用本地文件实现中，不需要预签名URL
-    // 直接返回文件路径
+    // In desktop application local file implementation, pre-signed URL is not needed
+    // Directly return the file path
     return key;
   }
 
   /**
-   * 创建预签名预览URL（本地版是通过HTTP路径访问本地文件）
+   * Create pre-signed preview URL (local version accesses local files via HTTP path)
    */
   async createPreSignedUrlForPreview(key: string): Promise<string> {
     return this.getLocalFileUrl(key);
@@ -49,13 +49,13 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
   }
 
   /**
-   * 批量删除文件
+   * Delete files in batch
    */
   async deleteFiles(keys: string[]): Promise<any> {
     try {
       if (!keys || keys.length === 0) return { success: true };
 
-      // 确保所有路径都是合法的desktop://路径
+      // Ensure all paths are valid desktop:// paths
       const invalidKeys = keys.filter((key) => !key.startsWith('desktop://'));
       if (invalidKeys.length > 0) {
         console.error('Invalid desktop file paths:', invalidKeys);
@@ -65,7 +65,7 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
         };
       }
 
-      // 使用electronIpcClient的专用方法
+      // Use electronIpcClient's dedicated method
       return await electronIpcClient.deleteFiles(keys);
     } catch (error) {
       console.error('Failed to delete files:', error);
@@ -82,20 +82,20 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
   }
 
   /**
-   * 获取文件字节数组
+   * Get file byte array
    */
   async getFileByteArray(key: string): Promise<Uint8Array> {
     try {
-      // 从Electron获取文件的绝对路径
+      // Get absolute file path from Electron
       const filePath = await electronIpcClient.getFilePathById(key);
 
-      // 检查文件是否存在
+      // Check if file exists
       if (!existsSync(filePath)) {
         console.error(`File not found: ${filePath}`);
         return new Uint8Array();
       }
 
-      // 读取文件内容并转换为Uint8Array
+      // Read file content and convert to Uint8Array
       const buffer = readFileSync(filePath);
       return new Uint8Array(buffer);
     } catch (e) {
@@ -105,20 +105,20 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
   }
 
   /**
-   * 获取文件内容
+   * Get file content
    */
   async getFileContent(key: string): Promise<string> {
     try {
-      // 从Electron获取文件的绝对路径
+      // Get absolute file path from Electron
       const filePath = await electronIpcClient.getFilePathById(key);
 
-      // 检查文件是否存在
+      // Check if file exists
       if (!existsSync(filePath)) {
         console.error(`File not found: ${filePath}`);
         return '';
       }
 
-      // 读取文件内容并转换为字符串
+      // Read file content and convert to string
       return readFileSync(filePath, 'utf8');
     } catch (e) {
       console.error('Failed to get file content:', e);
@@ -127,7 +127,7 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
   }
 
   /**
-   * 获取完整文件URL
+   * Get full file URL
    */
   async getFullFileUrl(url?: string | null): Promise<string> {
     if (!url) return '';
@@ -139,32 +139,32 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
   }
 
   /**
-   * 上传内容
-   * 注意：这个功能可能需要扩展Electron IPC接口
+   * Upload content
+   * Note: This feature may require extension of Electron IPC interface
    */
   async uploadContent(filePath: string, content: string): Promise<any> {
-    // 这里需要扩展electronIpcClient以支持上传文件内容
-    // 例如: return electronIpcClient.uploadContent(filePath, content);
+    // Need to extend electronIpcClient to support uploading file content
+    // For example: return electronIpcClient.uploadContent(filePath, content);
     console.warn('uploadContent not implemented for Desktop local file service', filePath, content);
     return;
   }
 
   /**
-   * 从完整URL中提取key
-   * 从 HTTP URL 中提取 desktop:// 格式的路径
+   * Extract key from full URL
+   * Extract desktop:// format path from HTTP URL
    */
   getKeyFromFullUrl(url: string): string {
     try {
       const urlObj = new URL(url);
       const pathSegments = urlObj.pathname.split('/').filter((segment) => segment !== '');
 
-      // 移除第一个路径段（desktop-file）
+      // Remove first path segment (desktop-file)
       pathSegments.shift();
 
-      // 重新组合剩余的路径段
+      // Recombine remaining path segments
       const filePath = pathSegments.join('/');
 
-      // 返回 desktop:// 格式的路径
+      // Return desktop:// format path
       return `desktop://${filePath}`;
     } catch (e) {
       console.error('[DesktopLocalFileImpl] Failed to extract key from URL:', e);
@@ -173,23 +173,23 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
   }
 
   /**
-   * 上传媒体文件
+   * Upload media file
    */
   async uploadMedia(key: string, buffer: Buffer): Promise<{ key: string }> {
     try {
-      // 将 Buffer 转换为 Base64 字符串
+      // Convert Buffer to Base64 string
       const content = buffer.toString('base64');
 
-      // 从 key 中提取文件名
+      // Extract filename from key
       const filename = path.basename(key);
 
-      // 计算文件的 SHA256 hash
+      // Calculate SHA256 hash of the file
       const hash = sha256(buffer);
 
-      // 根据文件URL推断 MIME 类型
+      // Infer MIME type from file URL
       const type = inferContentTypeFromImageUrl(key)!;
 
-      // 构造上传参数
+      // Construct upload parameters
       const uploadParams = {
         content,
         filename,
@@ -198,7 +198,7 @@ export class DesktopLocalFileImpl implements FileServiceImpl {
         type,
       };
 
-      // 调用 electronIpcClient 上传文件
+      // Call electronIpcClient to upload file
       const result = await electronIpcClient.createFile(uploadParams);
 
       if (!result.success) {

package/src/server/services/file/impls/s3.ts

@@ -7,7 +7,7 @@ import { FileServiceImpl } from './type';
 import { extractKeyFromUrlOrReturnOriginal } from './utils';
 
 /**
- * 基于S3的文件服务实现
+ * S3-based file service implementation
  */
 export class S3StaticFileImpl implements FileServiceImpl {
   private readonly s3: S3;

package/src/server/services/file/impls/type.ts

@@ -1,54 +1,54 @@
 /**
- * S3文件服务实现
+ * File service implementation interface
  */
 export interface FileServiceImpl {
   /**
-   * 创建预签名上传URL
+   * Create pre-signed upload URL
    */
   createPreSignedUrl(key: string): Promise<string>;
 
   /**
-   * 创建预签名预览URL
+   * Create pre-signed preview URL
    */
   createPreSignedUrlForPreview(key: string, expiresIn?: number): Promise<string>;
 
   /**
-   * 删除文件
+   * Delete file
    */
   deleteFile(key: string): Promise<any>;
 
   /**
-   * 批量删除文件
+   * Delete files in batch
    */
   deleteFiles(keys: string[]): Promise<any>;
 
   /**
-   * 获取文件字节数组
+   * Get file byte array
    */
   getFileByteArray(key: string): Promise<Uint8Array>;
 
   /**
-   * 获取文件内容
+   * Get file content
    */
   getFileContent(key: string): Promise<string>;
 
   /**
-   * 获取完整文件URL
+   * Get full file URL
    */
   getFullFileUrl(url?: string | null, expiresIn?: number): Promise<string>;
 
   /**
-   * 从完整URL中提取key
+   * Extract key from full URL
    */
   getKeyFromFullUrl(url: string): string;
 
   /**
-   * 上传内容
+   * Upload content
    */
   uploadContent(path: string, content: string): Promise<any>;
 
   /**
-   * 上传媒体文件
+   * Upload media file
    */
   uploadMedia(key: string, buffer: Buffer): Promise<{ key: string }>;
 }

package/src/server/services/file/index.ts

@@ -11,8 +11,8 @@ import { TempFileManager } from '@/server/utils/tempFileManager';
 import { FileServiceImpl, createFileServiceModule } from './impls';
 
 /**
- * 文件服务类
- * 使用模块化实现方式，提供文件操作服务
+ * File service class
+ * Provides file operation services using a modular implementation approach
  */
 export class FileService {
   private userId: string;
@@ -26,70 +26,70 @@ export class FileService {
   }
 
   /**
-   * 删除文件
+   * Delete file
    */
   public async deleteFile(key: string) {
     return this.impl.deleteFile(key);
   }
 
   /**
-   * 批量删除文件
+   * Delete files in batch
    */
   public async deleteFiles(keys: string[]) {
     return this.impl.deleteFiles(keys);
   }
 
   /**
-   * 获取文件内容
+   * Get file content
    */
   public async getFileContent(key: string): Promise<string> {
     return this.impl.getFileContent(key);
   }
 
   /**
-   * 获取文件字节数组
+   * Get file byte array
    */
   public async getFileByteArray(key: string): Promise<Uint8Array> {
     return this.impl.getFileByteArray(key);
   }
 
   /**
-   * 创建预签名上传URL
+   * Create pre-signed upload URL
    */
   public async createPreSignedUrl(key: string): Promise<string> {
     return this.impl.createPreSignedUrl(key);
   }
 
   /**
-   * 创建预签名预览URL
+   * Create pre-signed preview URL
    */
   public async createPreSignedUrlForPreview(key: string, expiresIn?: number): Promise<string> {
     return this.impl.createPreSignedUrlForPreview(key, expiresIn);
   }
 
   /**
-   * 上传内容
+   * Upload content
    */
   public async uploadContent(path: string, content: string) {
     return this.impl.uploadContent(path, content);
   }
 
   /**
-   * 获取完整文件URL
+   * Get full file URL
    */
   public async getFullFileUrl(url?: string | null, expiresIn?: number): Promise<string> {
     return this.impl.getFullFileUrl(url, expiresIn);
   }
 
   /**
-   * 从完整 URL中 提取 key
+   * Extract key from full URL
    */
   public getKeyFromFullUrl(url: string): string {
     return this.impl.getKeyFromFullUrl(url);
   }
 
   /**
-   * 上传媒体文件
+   * Upload media file
    */
   public async uploadMedia(key: string, buffer: Buffer): Promise<{ key: string }> {
     return this.impl.uploadMedia(key, buffer);