Skip to content

Commit 297ee61

Browse files
authored
docs: sync app auth and automation updates (#129)
1 parent 7e2f69a commit 297ee61

13 files changed

Lines changed: 69 additions & 1 deletion

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33

44
# Local agent handoff and screenshot scratch output.
55
/HANDOFF.md
6+
/eval/
67
/images/_scratch/
78
/images/_tmp/
89
/images/_preview/

en/basic/admin-panel/ai-setting.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,8 +104,16 @@ If you also need a custom domain, or if your server cannot access the Vercel API
104104
| Optional item | When you need it |
105105
|------|------|
106106
| **Custom domain** | When you want to publish apps under your own domain |
107+
| **App Auth** | When generated apps need **Email OTP** or **Google** sign-in |
107108
| **Vercel API proxy URL** | When your server cannot reach the Vercel API directly, or when you use a proxy or gateway |
108109

110+
In **App Auth**, you can configure sign-in providers for generated apps:
111+
112+
- **Email OTP** uses an independent SMTP mailbox for app login verification emails.
113+
- **Google OAuth** requires a Client ID and Client Secret. Add the redirect URI shown on this page to the authorized redirect URI list in Google Cloud Console.
114+
115+
**Teable** sign-in is available by default. **Email OTP** appears in App Builder only after the SMTP settings are complete, and **Google** appears only after both OAuth credentials are configured.
116+
109117
<Tip>
110118
Click **Test Public Access** in the page and confirm that both your **Teable instance** and **object storage (MinIO / S3)** are publicly accessible.
111119
</Tip>

en/basic/ai/ai-chat.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ AI prioritizes information from the current page:
2424

2525
Files can also be pasted or dropped directly into the input box. They appear as attachment chips first, then become available to AI after the message is sent.
2626

27+
When you paste a long block of plain text, Teable converts it to a Markdown attachment so the message input stays easy to read. You can preview text and Markdown attachments from their attachment chips.
28+
2729
## Common Uses
2830

2931
<CardGroup cols={2}>

en/basic/ai/app-builder.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,18 @@ Use **Custom domain** to bind a domain to the published app. A subdomain is reco
7676

7777
You can also use an available subdomain under `teable.app`, such as `your-name.teable.app`.
7878

79+
### App Login
80+
81+
Click **Add login** in the app header to require visitors to sign in before they can use the app. Once login is configured, the button changes to **Login settings**.
82+
83+
When you enable login:
84+
85+
1. Choose where to store app users. You can create a **Users** table or reuse an existing table with an email field. Each signed-in user is stored as one record, and the same user table can be reused by multiple apps.
86+
2. Choose at least one sign-in method, such as **Email OTP**, **Google**, or **Teable**. Available methods depend on your instance's authentication settings.
87+
3. Choose an access policy: **Anyone can sign up**, **Allowed email domains**, or **Invite only**.
88+
89+
Login changes appear in the preview after it reloads. Publish the app again to apply those changes to the live app.
90+
7991
### Version History & Rollback
8092
Teable automatically tracks every deployment.
8193
- Click the **History** (clock icon) button to view a list of all deployed versions.

en/basic/automation.mdx

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,13 @@ Changes are saved as a draft. The live workflow keeps running on the previous ve
4242

4343
Open a workflow → **Execution History**. Each run shows status, time spent, and per-step input/output. Click a run to inspect every step.
4444

45+
Use the history filters to narrow the list by status, duration, or date range. Failed runs can be rerun from the run detail panel:
46+
47+
- **Full rerun** runs every step again and may create duplicate records, emails, or notifications.
48+
- **Resume from failed step** is available when Teable can safely continue from the failed step.
49+
50+
Rerun attempts are marked as retries and link back to the original run.
51+
4552
## Limits
4653

4754
| Item | Limit |

en/basic/view/grid.mdx

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,10 @@ Changing row height does not affect field header height, which cannot be adjuste
4141

4242
If you want to ensure your preferred row height configuration isn't accidentally changed, you can lock the view (coming soon), which will prevent all collaborators from changing the view's configuration until someone with creator permissions unlocks it.
4343

44+
### Selection Statistics
45+
46+
When you select cells in grid view, Teable shows **Average**, **Count**, and **Sum** for the selected numeric cells.
47+
4448
### Hiding Fields in Grid View
4549

4650
To hide fields in grid view (or show hidden fields), click the "Hide Fields" button in the view bar to open the hide fields dialog. If there are no hidden fields in the current view, the "Hide Fields" button will appear as an eye icon with a line through it and display "Hide Fields."
@@ -76,4 +80,3 @@ Shorter row heights allow you to see more records at once, while larger row heig
7680
To expand a single row at a time, you can press the spacebar when any cell in the selected row is focused.
7781

7882
You can also view the full content of the current cell by clicking on it, then use arrow keys to quickly move between different cells.
79-

en/deploy/env.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,7 @@ Also ensure the public bucket is configured with **public-read + CORS**. See: [O
7272
| MAX_COPY_CELLS | Maximum number of cells to copy in a single request | - | - | 50000 |
7373
| MAX_READ_ROWS | Maximum number of rows to read in a single request | - | - | 10000 |
7474
| MAX_ATTACHMENT_UPLOAD_SIZE | Maximum attachment upload size (bytes) | - | - | 2147483648 |
75+
| MAX_SPACE_OWNER_COUNT | Maximum number of spaces a user can own | 10 | - | 10 |
7576
| Feature Toggles |
7677
| RECORD_HISTORY_DISABLED | Whether to disable record history, defaults to false | false | - | true |
7778
| PASSWORD_LOGIN_DISABLED | Whether to disable password login (OAuth and OIDC still available) | false | - | true |

zh/basic/admin-panel/ai-setting.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,8 +103,16 @@ Vercel 相关费用主要分成两部分:
103103
| 可选项 | 什么时候需要 |
104104
|------|------|
105105
| **自定义域名** | 需要把应用发布到自己的域名下 |
106+
| **应用登录** | 生成的应用需要支持 **邮箱验证码****Google** 登录时 |
106107
| **Vercel API 代理地址** | 服务器不能直接访问 Vercel API,或需要通过代理、网关访问 |
107108

109+
**应用登录** 中,可以为生成的应用配置登录提供方:
110+
111+
- **邮箱验证码** 使用独立 SMTP 邮箱发送应用登录验证码。
112+
- **Google 登录** 需要填写客户端 ID 和客户端密钥,并将页面中显示的回调地址添加到 Google Cloud Console 的已授权重定向 URI。
113+
114+
**Teable 登录** 默认可用。只有完整配置 SMTP 后,**邮箱验证码** 才会出现在应用构建器的登录设置中;只有同时配置 Google 客户端 ID 和密钥后,**Google** 登录才会出现。
115+
108116
<Tip>
109117
点击页面中的 **测试公网访问**,确认 **Teable 实例****对象存储(MinIO / S3)** 都已经可以从公网访问。
110118
</Tip>

zh/basic/ai/ai-chat.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ AI 会优先参考你当前页面中的信息:
2424

2525
你也可以直接把文件粘贴或拖拽到输入框中。文件会先显示为附件标签,发送后再交给 AI 参考。
2626

27+
较长的纯文本粘贴会转成 Markdown 附件,避免输入框被大段文本占满。文本和 Markdown 附件可从附件标签中打开预览。
28+
2729
## 常见用法
2830

2931
<CardGroup cols={2}>

zh/basic/ai/app-builder.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,18 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下,
8686

8787
也可以使用 `teable.app` 下可用的子域名,例如 `your-name.teable.app`
8888

89+
### 应用登录
90+
91+
在应用顶部点击 **添加登录**,可以要求访问者登录后再使用应用。配置后,该按钮会变为 **登录设置**
92+
93+
启用登录时:
94+
95+
1. 选择登录用户的存储位置。可以创建 **用户** 表,也可以复用已有的、包含邮箱字段的表。每位登录用户会作为一条记录保存,同一用户表可被多个应用复用。
96+
2. 至少选择一种登录方式,例如 **邮箱验证码****Google****Teable**。可选方式取决于实例的认证配置。
97+
3. 设置访问控制:**所有人可注册****允许的邮箱域名****仅邀请用户**
98+
99+
登录配置会在预览重新加载后生效。要让线上应用使用新的登录配置,需要重新发布应用。
100+
89101
### 版本历史与回滚
90102

91103
Teable 自动跟踪每一次部署。

0 commit comments

Comments
 (0)