From ae60645b815cfe3240035cdfe40bdb64319492c5 Mon Sep 17 00:00:00 2001 From: HynLcc Date: Thu, 30 Apr 2026 18:39:25 +0800 Subject: [PATCH] docs: clarify app builder env archive handling --- en/basic/ai/app-builder.mdx | 3 +++ zh/basic/ai/app-builder.mdx | 3 +++ 2 files changed, 6 insertions(+) diff --git a/en/basic/ai/app-builder.mdx b/en/basic/ai/app-builder.mdx index 6d765e9..3329986 100644 --- a/en/basic/ai/app-builder.mdx +++ b/en/basic/ai/app-builder.mdx @@ -46,6 +46,8 @@ You can download the entire app as a ZIP archive at any time: 2. Click the **`...`** menu in the tab bar. 3. Select **Download code** to save a ZIP archive that includes all source files. +If the app uses custom environment variables, the downloaded archive can include a root `.env` file. Review it before sharing the ZIP. + #### Import Code You can update the app's code by importing a ZIP: 1. Switch to the **Code** tab in the editor. @@ -56,6 +58,7 @@ You can update the app's code by importing a ZIP: - Include source files only — do not include `node_modules`, `.next`, or other build artifacts. - Zip the outermost project folder itself (right-click the folder → compress), not files selected from inside it. - Import merges with the existing project and overwrites any files that share the same path. +- A root `.env` file in the ZIP is read into the app's custom environment variables. Other `.env*` variants, such as `.env.local`, are ignored. ![](/images/2026-02-28-18-14-08.png) diff --git a/zh/basic/ai/app-builder.mdx b/zh/basic/ai/app-builder.mdx index 29e0f30..25326f0 100644 --- a/zh/basic/ai/app-builder.mdx +++ b/zh/basic/ai/app-builder.mdx @@ -52,6 +52,8 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下， 2. 点击标签栏中的 **`...`** 菜单。 3. 选择 **下载代码**，包含所有源文件的 ZIP 压缩包将保存到您的电脑。 +如果应用使用了自定义环境变量，下载的压缩包可能包含根目录 `.env` 文件。分享 ZIP 前请先检查其中内容。 + #### 导入代码 您可以通过导入 ZIP 来更新应用代码： @@ -64,6 +66,7 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下， - 仅需包含源代码文件，请勿包含 `node_modules`、`.next` 等构建产物。 - 请压缩最外层项目文件夹本身（右键文件夹 → 压缩），而非进入文件夹内部选中文件再压缩。 - 导入会合并并覆盖同名文件。 +- ZIP 中的根目录 `.env` 会被读取为应用的自定义环境变量。其他 `.env*` 变体（如 `.env.local`）会被忽略。 ![](/images/2026-02-28-18-23-27.png)