Skip to content

docs: clarify App Builder env archive handling #120

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
HynLcc merged 1 commit into from
Apr 30, 2026
+6 −0
Merged

docs: clarify App Builder env archive handling #120

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions en/basic/ai/app-builder.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.
</Note>

![](/images/2026-02-28-18-14-08.png)
Expand Down
3 changes: 3 additions & 0 deletions zh/basic/ai/app-builder.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,8 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下，
2. 点击标签栏中的 **`...`** 菜单。
3. 选择 **下载代码**，包含所有源文件的 ZIP 压缩包将保存到您的电脑。

如果应用使用了自定义环境变量，下载的压缩包可能包含根目录 `.env` 文件。分享 ZIP 前请先检查其中内容。

#### 导入代码

您可以通过导入 ZIP 来更新应用代码：
Expand All @@ -64,6 +66,7 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下，
- 仅需包含源代码文件，请勿包含 `node_modules`、`.next` 等构建产物。
- 请压缩最外层项目文件夹本身（右键文件夹 → 压缩），而非进入文件夹内部选中文件再压缩。
- 导入会合并并覆盖同名文件。
- ZIP 中的根目录 `.env` 会被读取为应用的自定义环境变量。其他 `.env*` 变体（如 `.env.local`）会被忽略。
</Note>

![](/images/2026-02-28-18-23-27.png)
Expand Down