1. Project Overview & Quickstart (teableio/LICENSE)
1. Project Overview & Quickstart (teableio/LICENSE)
LICENSE
Open-source repository teableio/LICENSE
Repository Details
- Repository: teableio/LICENSE
- Primary Language: Code
Note: High-volume repository documentation is actively indexed and synchronized by YakaAI.
2. Official Technical Reference & Guides (teableio/docs)
Teable Help
Development
Install the Mintlify CLI to preview the documentation changes locally. To install, use the following command
npm i mintlifyRun the following command at the root of your documentation (where docs.json is)
mintlify devPaste Image
Use the Paste Image extension to paste images into the markdown file.
Open mdx file and press cmd + option + v to paste image.
Image Assets
Images are shared repo assets. Keep paths stable, names searchable, and
rendering consistent.
When a change includes images, ask the agent to read this section first and
commit only images processed according to these rules.
Folder Rules
- Use
images/{top-level-group}/{topic}/. - Top-level groups:
docs,selfhosted,api,security,changelog. docsmaps to the Help Center Docs tab. Do not flattenimages/docs/{topic}/intoimages/{topic}/.{topic}maps to the navigation name indocs.json, such asai,base,space,sso,authority-matrix,get-id,sql-query, oractivate.- Do not put new screenshots in the
images/root. - Do not commit random staging folders.
- Put unreferenced images in
images/orphans/YYYY-MM-DD/...first. Do not
delete them directly. - Docs pages must not reference
images/orphans/....
Naming
Use this format:
images/{top-level-group}/{topic}/YYYY-MM-DD-page-slug-purpose.png
images/{top-level-group}/{topic}/YYYY-MM-DD-page-slug-purpose.webp
images/{top-level-group}/{topic}/YYYY-MM-DD-page-slug-purpose-zh.png- Date = day the image enters the docs repo.
- Page slug = docs page or feature area.
- Purpose = visible UI or action. Do not use
image1or random hashes. - Use
.pngfor static UI screenshots. - Prefer
.webpfor animated screenshots. - English-only screenshot = shared asset. Do not add
-en. - Chinese-specific screenshot = add
-zh.
Image Handling
- Logos, inline icons, external button images, videos, and historical changelog
media do not need screenshot styling.
MDX Usage
Use explicit `` for docs screenshots:
- Use
className="docs-screenshot"for new PNG/WebP docs screenshots underimages/docs/,images/api/,images/selfhosted/, andimages/security/. - Alt text must be non-empty.
- Alt text describes the visible UI or action. Do not use
screenshotor the
file name. - Do not use `` for new docs screenshots.
- Avoid
width="400", percentage widths, and one-off image sizing. - Changelog images keep their historical display. Add useful alt text when
context exists. Do not adddocs-screenshotblindly.
Publishing Changes
Push to origin main branch, the changes will be deployed to production automatically.
Troubleshooting
- Mintlify dev isn't running - Run
mintlify installit'll re-install dependencies. - Page loads as a 404 - Make sure you are running in a folder with docs.json
2. Official Technical Reference & Guides (teableio/docs)
Teable Help
Development
Install the Mintlify CLI to preview the documentation changes locally. To install, use the following command
npm i mintlifyRun the following command at the root of your documentation (where docs.json is)
mintlify devPaste Image
Use the Paste Image extension to paste images into the markdown file.
Open mdx file and press cmd + option + v to paste image.
Image Assets
Images are shared repo assets. Keep paths stable, names searchable, and
rendering consistent.
When a change includes images, ask the agent to read this section first and
commit only images processed according to these rules.
Folder Rules
- Use
images/{top-level-group}/{topic}/. - Top-level groups:
docs,selfhosted,api,security,changelog. docsmaps to the Help Center Docs tab. Do not flattenimages/docs/{topic}/intoimages/{topic}/.{topic}maps to the navigation name indocs.json, such asai,base,space,sso,authority-matrix,get-id,sql-query, oractivate.- Do not put new screenshots in the
images/root. - Do not commit random staging folders.
- Put unreferenced images in
images/orphans/YYYY-MM-DD/...first. Do not
delete them directly. - Docs pages must not reference
images/orphans/....
Naming
Use this format:
images/{top-level-group}/{topic}/YYYY-MM-DD-page-slug-purpose.png
images/{top-level-group}/{topic}/YYYY-MM-DD-page-slug-purpose.webp
images/{top-level-group}/{topic}/YYYY-MM-DD-page-slug-purpose-zh.png- Date = day the image enters the docs repo.
- Page slug = docs page or feature area.
- Purpose = visible UI or action. Do not use
image1or random hashes. - Use
.pngfor static UI screenshots. - Prefer
.webpfor animated screenshots. - English-only screenshot = shared asset. Do not add
-en. - Chinese-specific screenshot = add
-zh.
Image Handling
- Logos, inline icons, external button images, videos, and historical changelog
media do not need screenshot styling.
MDX Usage
Use explicit `` for docs screenshots:
- Use
className="docs-screenshot"for new PNG/WebP docs screenshots underimages/docs/,images/api/,images/selfhosted/, andimages/security/. - Alt text must be non-empty.
- Alt text describes the visible UI or action. Do not use
screenshotor the
file name. - Do not use `` for new docs screenshots.
- Avoid
width="400", percentage widths, and one-off image sizing. - Changelog images keep their historical display. Add useful alt text when
context exists. Do not adddocs-screenshotblindly.
Publishing Changes
Push to origin main branch, the changes will be deployed to production automatically.
Troubleshooting
- Mintlify dev isn't running - Run
mintlify installit'll re-install dependencies. - Page loads as a 404 - Make sure you are running in a folder with docs.json