Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.
Building Tips
1. Define data first
Teable App Builder works on top of your existing Teable tables — your tables and fields are your schema, and the AI reads them directly when generating UI and logic.So before you start building, define your data model clearly. The more precise your field types, links, and read/write paths are, the higher the quality of what the AI produces.For practical use cases, see no-code business app examples.
2. Plan before you build
Once your data model is in place, still resist the urge to jump straight into building the UI. Run a planning pass with the AI first.Say something like: “Let’s not write code yet — let’s make a plan.” Describe the problem you’re solving, the target users, and the rough feature set. Let the AI draft a structured proposal. Review it, adjust it, and only start building once you agree the plan makes sense.
A few extra minutes aligning on direction up front saves hours of rework later.
Don’t try to cram every feature into a single prompt. Describe the core functionality first, get a minimal working version running, then add one thing at a time: one interaction, one style tweak, one piece of logic.Verify each change before moving on. When something breaks, you only need to roll back one small change instead of starting over.
4. Be specific, not abstract
Descriptions like “make it prettier” or “make the interactions feel more natural” carry almost no information for the AI.Effective prompts are concrete: which page, which area, what behavior you want, what you don’t want. Attaching screenshots or reference UIs helps a lot.
Treat your prompt like a brief for a smart person who knows nothing about your project. The more precise the instructions, the closer the output gets to what you imagined.
5. Diagnose before fixing
When the app behaves unexpectedly, resist the urge to tell the AI to “just fix it.” Vague fix instructions push the AI into blindly patching things, often introducing new bugs along the way.A better approach is two steps:
1
Ask the AI to analyze first
Describe the symptoms and ask the AI to list likely causes and possible approaches — without touching the code yet.
2
Pick a direction, then implement
Decide which explanation is most plausible, and tell the AI to proceed along that path.
If several fix attempts in a row fail, roll back to the last known-good version and start fresh. It’s usually faster than patching on top of patches.
6. Lean on version rollbacks
Every conversation with the AI produces changes. The recommended rhythm: finish one feature module, confirm it works, then move on. Don’t juggle multiple unfinished features at once.Later change broke something? Roll back to the last stable version and try again with a clearer prompt.
FAQ
App Builder only supports Next.js
App Builder’s runtime environment (sandbox, preview, and build) is built on Next.js and currently does not support other frontend frameworks, including Astro, Vite, Create React App, Vue, Svelte, etc.If you ask the AI to use a non-Next.js framework, it may not consistently refuse and might even attempt to generate the corresponding code. However, since the underlying environment is incompatible, the preview will fail to start — you’ll be stuck on “Preview is starting…” indefinitely, and conversations will continue to consume credits during this time.
If you need to use a framework other than Next.js, we recommend developing in your own local environment and connecting to your data via the Teable API.
Handling 429 errors
The Teable API is currently limited to 10 QPS (10 requests per second). Apps generated by App Builder can hit 429 errors during normal use if request handling isn’t optimized. Our engineering team is actively working on optimizing API performance, and we may adjust this limit in the future.
There are four broad strategies to address this:
Caching
Reduce duplicate requests
Pagination & batching
Shrink per-request payloads
Debounce & throttle
Lower request frequency
Rendering compatibility
Reduce preview errors
Each section below lists common scenarios, the fix, and a reference prompt you can reuse.Caching — reduce duplicate requests
Display-heavy pages and dashboards can trigger too many requests on load
Scenario: A dashboard page has multiple charts, stat cards, and lists, each querying a different table. Or the page is mainly for display, but every visit still hits the API directly. In both cases, page-load concurrency can spike, and traffic surges are more likely to trigger 429 errors.Fix: Prefer cache-friendly rendering patterns. Cache data in app memory after loading (a 1–3 minute TTL is a good starting point) and reuse it on later visits. Lazy-load below-the-fold components to stagger requests. If the page still re-fetches on every visit, explicitly ask the AI to strengthen the caching strategy.
Reference prompt: “This is a display-heavy page. Prefer a cache-friendly rendering approach. Cache data locally after page load with a 1-minute TTL, don’t re-request the API within the TTL window, and delay below-the-fold components by 500 ms.”
Multiple components querying the same table
Scenario: Three components on the same page each need data from the same table and each fires its own request — when one would have been enough.Fix: Centralize data fetching so the same dataset is loaded once and shared across components.
Reference prompt: “If multiple components need data from the same table, fetch it once and share it across all of them. Do not fire duplicate requests.”
Re-fetching on page navigation
Scenario: Users move back and forth between pages. Each return triggers a fresh fetch, even when nothing has changed.Fix: Within the cache TTL, reuse the previously loaded data instead of re-requesting.
Reference prompt: “When a user returns to a page, if it’s been less than 1 minute since the last load, use the cached data. Do not re-request the API.”
Dropdowns loading huge option lists
Scenario: A dropdown shows every record from a table as an option. With many records, that single request alone is heavy.Fix: Convert it into a search-style picker — only fetch matching records after the user types. Alternatively, cache the option list.
Reference prompt: “Dropdowns should not load all options upfront. Switch to a keyword search that fetches matching records on input, with debounce applied.”
Cascading selectors chaining requests
Scenario: Choosing one field triggers a load for the next level’s options. Multi-level cascades rack up several requests per interaction.Fix: Preload the related data once and filter locally, or cache cascade data after the first load.
Reference prompt: “Cache cascading selector option data locally after loading. When the user changes a parent option, filter from the cache instead of re-requesting.”
Re-renders triggering duplicate requests
Scenario: Poor state management causes components to re-fetch data on every render.Fix: Trigger data fetching on specific events (initial mount, explicit user action), not on every render. Use caching as a safety net.
Reference prompt: “Only fetch data on first page load or explicit user actions. Do not re-fetch on re-renders — use cached data instead.”
Scenario: Loading all records at once produces a flood of API calls when the dataset grows.Fix: Paginate. Only fetch the current page’s data.
Reference prompt: “Show 20 rows per page. Only load the next page when the user navigates to it. Do not load everything at once.”
Per-row fetching for linked data (N+1)
Scenario: After loading a list, you fetch linked-table details for each record one at a time. Loading 50 projects and then 50 owner lookups = 50 extra requests in an instant.Fix: Fetch all linked data in one batch, not row by row.
Reference prompt: “When loading a list, batch-fetch all linked data in a single request. Do not loop through records to fetch their linked information individually.”
Per-row writes during bulk updates
Scenario: Bulk-updating multiple records by sending one update request per record instead of a single batch request.Fix: Use the batch update API to submit all changes in one call.
Reference prompt: “For bulk operations, merge multiple record changes into a single batch request. Do not send one update per record.”
API calls inside loops
Scenario: A for loop processes records one at a time, calling the API each iteration.Fix: Collect all the IDs first, then issue a single batch request.
Reference prompt: “Do not call the API inside a loop. Collect all required IDs first, then issue a single batch request.”
Debounce & throttle — lower request frequency
Search or filters without debounce
Scenario: Every keystroke in a search box fires a request. Typing a 4-character query produces 4 requests.Fix: Debounce the input — wait 300–500 ms after the user stops typing before firing the request.
Reference prompt: “Debounce the search input. Only send a request 300 ms after the user stops typing. Do not send requests mid-typing.”
Rapid repeated user actions
Scenario: Rapid-fire submit clicks, quick filter toggling, fast pagination — each action fires a request immediately.Fix: Apply debounce or throttle. Disable submit buttons until the request completes to prevent double-submits.
Reference prompt: “Disable the submit button after click and re-enable it once the request resolves. Debounce filter changes so rapid changes within 300 ms fire only one request.”
Overly aggressive form auto-save
Scenario: Every field change saves immediately. Filling out a form can trigger a dozen writes.Fix: Switch to explicit save on button click, or debounce auto-save so it fires once after a pause in editing.
Reference prompt: “Do not save on every field change. Save on explicit button click, or auto-save once after the user has paused editing for 2 seconds.”
Polling intervals that are too short
Scenario: Data refreshes every few seconds, producing sustained high-frequency traffic.Fix: Lengthen the poll interval to something reasonable (30 seconds or more), or switch to manual refresh.
Reference prompt: “Set the auto-refresh interval to 60 seconds. Add a manual refresh button so users can pull the latest data on demand.”
Multiple components polling independently
Scenario: Several components on a page each set up their own poll timer. The combined load easily exceeds the limit.Fix: Centralize polling. Run one periodic fetch, then fan the result out to every component that needs it.
Reference prompt: “Don’t let each component set up its own poll timer. Use a single refresh mechanism that fetches everything on a schedule and distributes the data to the components.”
Rendering compatibility — reduce preview errors
Charts, maps, or browser-only components fail in preview
Scenario: The page uses charts, maps, or libraries that depend on window, DOM measurements, or other browser-only APIs, and the preview shows errors, a blank screen, or hydration mismatches.Fix: These components are often safer to load in the browser instead of rendering them directly on the server. If preview issues persist, explicitly ask the AI to switch them to a browser-only loading pattern.
Reference prompt: “This component depends on the browser environment. Load it only on the client to avoid preview rendering errors or hydration mismatches.”
AI can make mistakes. Please double-check responses.
Last modified on October 21, 2026
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Teable","colors":{"primary":"#131415","light":"#131415","dark":"#F9FAFB"},"logo":{"light":"https://mintcdn.com/teablecn/Sov59EnEPMakaGyj/images/teable-logo-full.png?fit=max\u0026auto=format\u0026n=Sov59EnEPMakaGyj\u0026q=85\u0026s=24e1fe49258a9a8f76eaec5792623926","dark":"https://mintcdn.com/teablecn/Sov59EnEPMakaGyj/images/teable-logo-full-dark.png?fit=max\u0026auto=format\u0026n=Sov59EnEPMakaGyj\u0026q=85\u0026s=be076104208b417182461b52d697a124","href":"https://teable.ai"},"favicon":"https://mintcdn.com/teablecn/MGUqMJ8iafwbPo_j/images/teable-logo.png?fit=max\u0026auto=format\u0026n=MGUqMJ8iafwbPo_j\u0026q=85\u0026s=bd76b377e5d2b5c43bd18f20ddb0c6ad","seo":{"metatags":{"og:image":"https://teable.ai/assets/images/og-image.png","twitter:site":"@teableai","twitter:card":"summary_large_image","canonical":"https://help.teable.ai","description":"Teable is an AI-powered database and app builder. Build apps, automate workflows, and manage data with ease.","keywords":"database, app builder, AI, no-code, low-code, Airtable alternative, PostgreSQL, automation"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-LQ8H9TEDRD"}},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","banner":{"content":"🚀 Share your projects as templates. See our [changelog](/en/changelog#nov-20-2026) for details.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Support"}]},"href":"en"},{"language":"zh","banner":{"content":"🚀 把项目做成模板分享。查看[更新日志](/zh/changelog#2026-11-20)了解详情。","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"支持"}]},"href":"zh"},{"language":"ru","banner":{"content":"🚀 Делитесь проектами как шаблонами. Подробнее в [журнале изменений](/ru/changelog#20-ноября-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Поддержка"}]},"href":"ru"},{"language":"de","banner":{"content":"🚀 Teile deine Projekte als Vorlagen. Details im [Änderungsprotokoll](/de/changelog#20-november-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Support"}]},"href":"de"},{"language":"fr","banner":{"content":"🚀 Partagez vos projets sous forme de modèles. Consultez notre [journal des modifications](/fr/changelog#20-novembre-2026) pour en savoir plus.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Assistance"}]},"href":"fr"},{"language":"es","banner":{"content":"🚀 Comparte tus proyectos como plantillas. Consulta el [registro de cambios](/es/changelog#20-de-noviembre-de-2026) para más detalles.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Soporte"}]},"href":"es"},{"language":"it","banner":{"content":"🚀 Condividi i tuoi progetti come modelli. Scopri i dettagli nel [registro delle modifiche](/it/changelog#20-novembre-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Supporto"}]},"href":"it"},{"language":"ja","banner":{"content":"🚀 プロジェクトをテンプレートとして共有。詳しくは[更新履歴](/ja/changelog#2026年11月20日)をご覧ください。","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"サポート"}]},"href":"ja"},{"language":"tr","banner":{"content":"🚀 Projelerinizi şablon olarak paylaşın. Ayrıntılar için [değişiklik günlüğüne](/tr/changelog#20-kasım-2026) bakın.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Destek"}]},"href":"tr"},{"language":"uk","banner":{"content":"🚀 Діліться проєктами як шаблонами. Докладніше в [журналі змін](/uk/changelog#20-листопада-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Підтримка"}]},"href":"uk"},{"language":"ar","banner":{"content":"🚀 شارك مشاريعك كقوالب. راجع [سجل التغييرات](/ar/changelog#20-نوفمبر-2026) لمعرفة التفاصيل.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"الدعم"}]},"href":"ar"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"teablecn","hasAudioNarration":false,"actualSubdomain":"teablecn","customDomains":["help.teable.ai"],"gitSource":{"type":"github","owner":"teableio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6affe9183c0658a430f8c4d4","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"ar","tag":"واجهة API","count":737},{"language":"de","tag":"API","count":737},{"language":"en","tag":"API","count":737},{"language":"es","tag":"API","count":737},{"language":"fr","tag":"API","count":737},{"language":"it","tag":"API","count":737},{"language":"ja","tag":"API","count":737},{"language":"ru","tag":"API","count":737},{"language":"tr","tag":"API","count":737},{"language":"uk","tag":"API","count":737},{"language":"zh","tag":"API 文档","count":737},{"language":"ar","tag":"مرجع واجهة API","count":726},{"language":"de","tag":"API-Referenz","count":726},{"language":"en","tag":"API Reference","count":726},{"language":"es","tag":"Referencia de la API","count":726},{"language":"fr","tag":"Référence de l’API","count":726},{"language":"it","tag":"Riferimento API","count":726},{"language":"ja","tag":"APIリファレンス","count":726},{"language":"ru","tag":"Справочник API","count":726},{"language":"tr","tag":"API Referansı","count":726},{"language":"uk","tag":"Довідник API","count":726},{"language":"zh","tag":"API Reference","count":726},{"language":"ar","tag":"admin","count":145},{"language":"de","tag":"admin","count":145},{"language":"en","tag":"admin","count":145},{"language":"es","tag":"admin","count":145},{"language":"fr","tag":"admin","count":145},{"language":"it","tag":"admin","count":145},{"language":"ja","tag":"admin","count":145},{"language":"ru","tag":"admin","count":145},{"language":"tr","tag":"admin","count":145},{"language":"uk","tag":"admin","count":145},{"language":"zh","tag":"admin","count":145},{"language":"zh","tag":"功能文档","count":120},{"language":"ar","tag":"الوثائق","count":118},{"language":"de","tag":"Dokumentation","count":118},{"language":"en","tag":"Docs","count":118},{"language":"es","tag":"Documentación","count":118},{"language":"fr","tag":"Documentation","count":118},{"language":"it","tag":"Documentazione","count":118},{"language":"ja","tag":"ドキュメント","count":118},{"language":"ru","tag":"Документация","count":118},{"language":"tr","tag":"Dokümanlar","count":118},{"language":"uk","tag":"Документація","count":118},{"language":"ar","tag":"المشروع","count":45},{"language":"ar","tag":"space","count":45},{"language":"de","tag":"Projekt","count":45},{"language":"de","tag":"space","count":45},{"language":"en","tag":"Project","count":45},{"language":"en","tag":"space","count":45},{"language":"es","tag":"Proyecto","count":45},{"language":"es","tag":"space","count":45},{"language":"fr","tag":"Projet","count":45},{"language":"fr","tag":"space","count":45},{"language":"it","tag":"Progetto","count":45},{"language":"it","tag":"space","count":45},{"language":"ja","tag":"プロジェクト","count":45},{"language":"ja","tag":"space","count":45},{"language":"ru","tag":"Проект","count":45},{"language":"ru","tag":"space","count":45},{"language":"tr","tag":"Proje","count":45},{"language":"tr","tag":"space","count":45},{"language":"uk","tag":"Проєкт","count":45},{"language":"uk","tag":"space","count":45},{"language":"zh","tag":"项目","count":45},{"language":"zh","tag":"space","count":45},{"language":"ar","tag":"project","count":39},{"language":"de","tag":"project","count":39},{"language":"en","tag":"project","count":39},{"language":"es","tag":"project","count":39},{"language":"fr","tag":"project","count":39},{"language":"it","tag":"project","count":39},{"language":"ja","tag":"project","count":39},{"language":"ru","tag":"project","count":39},{"language":"tr","tag":"project","count":39},{"language":"uk","tag":"project","count":39},{"language":"zh","tag":"project","count":39},{"language":"tr","tag":"Alan","count":35},{"language":"ar","tag":"الأتمتة","count":34},{"language":"de","tag":"Automatisierung","count":34},{"language":"en","tag":"Automation","count":34},{"language":"es","tag":"Automatización","count":34},{"language":"fr","tag":"Automatisation","count":34},{"language":"it","tag":"Automazione","count":34},{"language":"ja","tag":"オートメーション","count":34},{"language":"ru","tag":"Автоматизация","count":34},{"language":"tr","tag":"Otomasyon","count":34},{"language":"uk","tag":"Автоматизація","count":34},{"language":"zh","tag":"自动化","count":34},{"language":"ar","tag":"الحقل","count":30},{"language":"ar","tag":"automation","count":30},{"language":"de","tag":"Feld","count":30},{"language":"de","tag":"automation","count":30},{"language":"en","tag":"Field","count":30},{"language":"en","tag":"automation","count":30},{"language":"es","tag":"Campo","count":30},{"language":"es","tag":"automation","count":30},{"language":"fr","tag":"Champ","count":30},{"language":"fr","tag":"automation","count":30},{"language":"it","tag":"Campo","count":30},{"language":"it","tag":"automation","count":30},{"language":"ja","tag":"フィールド","count":30},{"language":"ja","tag":"automation","count":30},{"language":"ru","tag":"Поле","count":30},{"language":"ru","tag":"automation","count":30},{"language":"tr","tag":"automation","count":30},{"language":"uk","tag":"Поле","count":30},{"language":"uk","tag":"automation","count":30},{"language":"zh","tag":"字段","count":30},{"language":"zh","tag":"automation","count":30}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-logo{width:108px;height:28px;object-fit:contain}[data-continuous-changelog]>[data-changelog-footer],[data-changelog-year]>a{display:none!important}.changelog-year summary{display:flex;align-items:center;justify-content:space-between;list-style:none;cursor:pointer;padding:0.375rem 1rem;font-size:0.875rem;border-radius:0.75rem}.changelog-year summary::-webkit-details-marker{display:none}.changelog-year summary::marker{content:\"\"}.changelog-year summary svg{width:14px;height:14px;fill:none;stroke:currentColor;stroke-width:1.5}.changelog-year[open] summary svg{transform:rotate(90deg)}.changelog-year summary,.changelog-year a{color:#374151}.dark .changelog-year summary,.dark .changelog-year a{color:#9ca3af}.changelog-year summary:hover,.changelog-year a:hover{color:#111827}.dark .changelog-year summary:hover,.dark .changelog-year a:hover{color:#d1d5db}.changelog-year summary:focus-visible,.changelog-year a:focus-visible{outline:2px solid currentColor;outline-offset:-2px}.changelog-year ul{list-style:none;padding:0;margin:0}.changelog-year a{display:block;margin-block:0.125rem;padding:0.375rem 1rem 0.375rem 2rem;border-radius:0.75rem;font-size:0.875rem}.changelog-year a:hover,.changelog-year summary:hover{background:rgb(156 163 175 / 8%)}.changelog-year a[aria-current]{color:rgb(var(--primary));background:rgb(var(--primary) / 10%);text-shadow:-0.2px 0 0 currentColor, 0.2px 0 0 currentColor}.changelog-year a[aria-busy]{opacity:0.5}.changelog-next-month{display:block;padding-block:2rem}.changelog-next-month[hidden]{display:none}.update-container{scroll-margin-top:180px}.update-container[hidden],.toc-item[hidden]{display:none!important}.changelog-title-anchor{display:block;scroll-margin-top:180px}#content[data-continuous-changelog]{display:flex;flex-direction:column}#changelog-month-stream{display:contents}.changelog-next-month{order:1}.update-container>div:first-child{display:none!important}.update-container>div:has(>[data-component-part=\"update-content\"]){overflow:visible;min-width:0}#content .changelog-heading-link{color:inherit;font:inherit;text-decoration:none;border:0}#content .changelog-heading-link:focus-visible{outline:2px solid currentColor;outline-offset:4px}:has(>svg[style*=\"arrow-left-from-line\"]){display:none!important}.eyebrow{display:none!important}.docs-card-link{display:block;color:inherit!important;text-decoration:none!important}.docs-card-link .card{cursor:pointer}.docs-card-link:hover .card,.docs-card-link:focus-visible .card{border-color:rgb(var(--primary))!important}#header:has(~#content[data-page-href*=\"/changelog\"]) #page-title{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip-path:inset(50%);white-space:nowrap;border:0}#header:has(~#content[data-page-href*=\"/changelog\"]){position:relative;height:0!important;min-height:0!important;margin:0!important;padding:0!important}#header:has(~#content[data-page-href*=\"/changelog\"])>*{margin:0!important}#header:has(~#content[data-page-href*=\"/changelog\"]) .prose{display:none}#header:has(~#content[data-page-href*=\"/changelog\"]) #page-context-menu{position:absolute!important;right:0;top:0;z-index:10}#content[data-page-href*=\"/changelog\"]{margin-top:0!important}#content[data-page-href*=\"/changelog\"]>.update-container:first-of-type{padding-top:0!important}#content[data-page-href*=\"/changelog\"] [data-component-part=\"update-content\"]>h2:first-of-type{font-size:2rem;line-height:1.25;font-weight:700;letter-spacing:-0.025em;margin-top:0;margin-bottom:1.25rem;padding-inline-end:2.5rem}#content[data-page-href*=\"/changelog\"] [data-component-part=\"update-content\"]>h3{font-size:1.5rem;line-height:1.4;font-weight:600}@media (width \u003c 640px){#content[data-page-href*=\"/changelog\"] [data-component-part=\"update-content\"]>h2:first-of-type{font-size:1.75rem}}html:not(.dark){--primary: 19 20 21;--primary-light: 19 20 21;--primary-dark: 19 20 21}.dark{--primary: 249 250 251;--primary-light: 249 250 251;--primary-dark: 249 250 251}#banner{background:rgb(var(--primary))!important}@layer utilities{html:not(.dark) #banner,html:not(.dark) #banner *{color:rgb(249, 250, 251)!important}html:not(.dark) #banner a{color:rgb(249, 250, 251)!important;text-decoration-color:rgba(249, 250, 251, 0.7)!important}.dark #banner,.dark #banner *{color:rgb(19, 20, 21)!important}.dark #banner a{color:rgb(19, 20, 21)!important;text-decoration-color:rgba(19, 20, 21, 0.35)!important}}[data-component-part=\"update-label\"]{background:rgba(17, 17, 17, 0.08)!important;color:#111111!important;border:1px solid rgba(17, 17, 17, 0.18)}.dark [data-component-part=\"update-label\"]{background:rgba(255, 255, 255, 0.1)!important;color:#f3f4f6!important;border-color:rgba(255, 255, 255, 0.25)}html[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-changelog-active=\"true\"]>a,html[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-active]>a,html[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-active-deepest]>a{color:rgb(var(--primary))!important;font-weight:600}html[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-changelog-active=\"true\"]::before,html[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-active]::before,html[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-active-deepest]::before{content:\"\";position:absolute;left:-12px;top:6px;bottom:6px;width:3px;border-radius:999px;background:rgb(var(--primary))}html.dark[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-changelog-active=\"true\"]>a,html.dark[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-active]>a,html.dark[data-current-path*=\"/changelog\"] #table-of-contents .toc-item[data-active-deepest]>a{color:rgb(var(--primary))!important}.callout[data-callout-type=\"note\"]{border-color:rgba(96, 165, 250, 0.45)!important;background:rgba(239, 246, 255, 0.9)!important}.callout[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"] svg{color:rgb(59, 130, 246)!important}.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"]{color:rgb(30, 64, 175)!important}.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"] strong,.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"] a,.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"] code,.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"] p,.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"] li,.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"] span{color:inherit!important}.dark .callout[data-callout-type=\"note\"]{border-color:rgba(96, 165, 250, 0.35)!important;background:rgba(30, 58, 138, 0.22)!important}.dark .callout[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"] svg{color:rgb(147, 197, 253)!important}.dark .callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"]{color:rgb(219, 234, 254)!important}.docs-screenshot{display:block;height:auto;max-width:100%;margin:1.5rem auto;overflow:hidden;vertical-align:middle;border:1px solid rgba(15, 23, 42, 0.08);border-radius:14px;width:auto}.dark .docs-screenshot{border-color:rgba(255, 255, 255, 0.12)}.docs-inline-icon{display:inline-block;width:1.4em;height:1.4em;margin:0 0.1em;vertical-align:-0.35em}.dark .docs-inline-icon{filter:invert(1)}@media (max-width: 640px){.docs-screenshot{margin:1.25rem auto;border-radius:12px}}@media (min-width: 1024px){#localization-select-trigger{position:fixed!important;bottom:16px!important;right:16px!important;left:auto!important;z-index:50!important}}"}]}
{"page":{"pagePath":"en/basic/ai/app-builder-practical-guide","slug":"/en/basic/ai/app-builder-practical-guide","pageMetadata":{"title":"App Builder tips: plan, prompt and troubleshoot","description":"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.","sidebarTitle":"App Builder Best Practices","href":"/en/basic/ai/app-builder-practical-guide"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,Heading,Note,Step,Steps,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`building-tips`,children:`Building Tips`}),`\n`,_jsx(Heading,{level:`3`,id:`1-define-data-first`,children:`1. Define data first`}),`\n`,_jsxs(_components.p,{children:[`Teable App Builder works on top of your existing Teable tables — `,_jsx(_components.strong,{children:`your tables and fields are your schema`}),`, and the AI reads them directly when generating UI and logic.`]}),`\n`,_jsx(_components.p,{children:`So before you start building, define your data model clearly. The more precise your field types, links, and read/write paths are, the higher the quality of what the AI produces.`}),`\n`,_jsxs(_components.p,{children:[`For practical use cases, see `,_jsx(_components.a,{href:`https://teable.ai/no-code-app-builder`,children:`no-code business app examples`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`2-plan-before-you-build`,children:`2. Plan before you build`}),`\n`,_jsx(_components.p,{children:`Once your data model is in place, still resist the urge to jump straight into building the UI. Run a planning pass with the AI first.`}),`\n`,_jsxs(_components.p,{children:[`Say something like: `,_jsx(_components.em,{children:`“Let’s not write code yet — let’s make a plan.”`}),` Describe the problem you’re solving, the target users, and the rough feature set. Let the AI draft a structured proposal. Review it, adjust it, and only start building once you agree the plan makes sense.`]}),`\n`,_jsx(Tip,{children:`A few extra minutes aligning on direction up front saves hours of rework later.`}),`\n`,_jsxs(_components.p,{children:[`For a broader comparison of tools, read `,_jsx(_components.a,{href:`https://teable.ai/blog/best-no-code-ai-app-builders`,children:`AI app builders compared by use case`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`3-start-small`,children:`3. Start small`}),`\n`,_jsx(_components.p,{children:`Don’t try to cram every feature into a single prompt. Describe the core functionality first, get a minimal working version running, then add one thing at a time: one interaction, one style tweak, one piece of logic.`}),`\n`,_jsx(_components.p,{children:`Verify each change before moving on. When something breaks, you only need to roll back one small change instead of starting over.`}),`\n`,_jsx(Heading,{level:`3`,id:`4-be-specific-not-abstract`,children:`4. Be specific, not abstract`}),`\n`,_jsxs(_components.p,{children:[`Descriptions like `,_jsx(_components.em,{children:`“make it prettier”`}),` or `,_jsx(_components.em,{children:`“make the interactions feel more natural”`}),` carry almost no information for the AI.`]}),`\n`,_jsxs(_components.p,{children:[`Effective prompts are concrete: `,_jsx(_components.strong,{children:`which page, which area, what behavior you want, what you don’t want`}),`. Attaching screenshots or reference UIs helps a lot.`]}),`\n`,_jsx(Tip,{children:`Treat your prompt like a brief for a smart person who knows nothing about your project. The more precise the instructions, the closer the output gets to what you imagined.`}),`\n`,_jsx(Heading,{level:`3`,id:`5-diagnose-before-fixing`,children:`5. Diagnose before fixing`}),`\n`,_jsxs(_components.p,{children:[`When the app behaves unexpectedly, resist the urge to tell the AI to `,_jsx(_components.em,{children:`“just fix it.”`}),` Vague fix instructions push the AI into blindly patching things, often introducing new bugs along the way.`]}),`\n`,_jsx(_components.p,{children:`A better approach is two steps:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Ask the AI to analyze first`,children:_jsx(_components.p,{children:`Describe the symptoms and ask the AI to list likely causes and possible approaches — without touching the code yet.`})}),_jsx(Step,{title:`Pick a direction, then implement`,children:_jsx(_components.p,{children:`Decide which explanation is most plausible, and tell the AI to proceed along that path.`})})]}),`\n`,_jsx(Warning,{children:`If several fix attempts in a row fail, roll back to the last known-good version and start fresh. It’s usually faster than patching on top of patches.`}),`\n`,_jsx(Heading,{level:`3`,id:`6-lean-on-version-rollbacks`,children:`6. Lean on version rollbacks`}),`\n`,_jsxs(_components.p,{children:[`Every conversation with the AI produces changes. The recommended rhythm: finish one feature module, confirm it works, then move on. `,_jsx(_components.strong,{children:`Don’t juggle multiple unfinished features at once.`})]}),`\n`,_jsx(_components.p,{children:`Later change broke something? Roll back to the last stable version and try again with a clearer prompt.`}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(Heading,{level:`3`,id:`app-builder-only-supports-next-js`,children:`App Builder only supports Next.js`}),`\n`,_jsxs(_components.p,{children:[`App Builder’s runtime environment (sandbox, preview, and build) is built on `,_jsx(_components.strong,{children:`Next.js`}),` and currently `,_jsx(_components.strong,{children:`does not support`}),` other frontend frameworks, including Astro, Vite, Create React App, Vue, Svelte, etc.`]}),`\n`,_jsxs(_components.p,{children:[`If you ask the AI to use a non-Next.js framework, it may not consistently refuse and might even attempt to generate the corresponding code. However, since the underlying environment is incompatible, `,_jsx(_components.strong,{children:`the preview will fail to start`}),` — you’ll be stuck on “Preview is starting…” indefinitely, and conversations will continue to consume credits during this time.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`If you need to use a framework other than Next.js, we recommend developing in your own local environment and connecting to your data via the Teable API.`})}),`\n`,_jsx(Heading,{level:`3`,id:`handling-429-errors`,children:`Handling 429 errors`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The Teable API is currently limited to `,_jsx(_components.strong,{children:`10 QPS`}),` (10 requests per second). Apps generated by App Builder can hit 429 errors during normal use if request handling isn’t optimized. Our engineering team is actively working on optimizing API performance, and we may adjust this limit in the future.`]})}),`\n`,_jsx(_components.p,{children:`There are four broad strategies to address this:`}),`\n`,_jsxs(CardGroup,{cols:4,children:[_jsx(Card,{title:`Caching`,icon:`database`,children:_jsx(_components.p,{children:`Reduce duplicate requests`})}),_jsx(Card,{title:`Pagination \u0026 batching`,icon:`layer-group`,children:_jsx(_components.p,{children:`Shrink per-request payloads`})}),_jsx(Card,{title:`Debounce \u0026 throttle`,icon:`gauge-high`,children:_jsx(_components.p,{children:`Lower request frequency`})}),_jsx(Card,{title:`Rendering compatibility`,icon:`window-restore`,children:_jsx(_components.p,{children:`Reduce preview errors`})})]}),`\n`,_jsx(_components.p,{children:`Each section below lists common scenarios, the fix, and a reference prompt you can reuse.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Caching — reduce duplicate requests`})}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Display-heavy pages and dashboards can trigger too many requests on load`,icon:`bolt`,id:`display-heavy-pages-and-dashboards-can-trigger-too-many-requests-on-load`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: A dashboard page has multiple charts, stat cards, and lists, each querying a different table. Or the page is mainly for display, but every visit still hits the API directly. In both cases, page-load concurrency can spike, and traffic surges are more likely to trigger 429 errors.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Prefer cache-friendly rendering patterns. Cache data in app memory after loading (a 1–3 minute TTL is a good starting point) and reuse it on later visits. Lazy-load below-the-fold components to stagger requests. If the page still re-fetches on every visit, explicitly ask the AI to strengthen the caching strategy.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “This is a display-heavy page. Prefer a cache-friendly rendering approach. Cache data locally after page load with a 1-minute TTL, don’t re-request the API within the TTL window, and delay below-the-fold components by 500 ms.”`]})})]}),_jsxs(Accordion,{title:`Multiple components querying the same table`,icon:`copy`,id:`multiple-components-querying-the-same-table`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Three components on the same page each need data from the same table and each fires its own request — when one would have been enough.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Centralize data fetching so the same dataset is loaded once and shared across components.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “If multiple components need data from the same table, fetch it once and share it across all of them. Do not fire duplicate requests.”`]})})]}),_jsxs(Accordion,{title:`Re-fetching on page navigation`,icon:`arrows-rotate`,id:`re-fetching-on-page-navigation`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Users move back and forth between pages. Each return triggers a fresh fetch, even when nothing has changed.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Within the cache TTL, reuse the previously loaded data instead of re-requesting.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “When a user returns to a page, if it’s been less than 1 minute since the last load, use the cached data. Do not re-request the API.”`]})})]}),_jsxs(Accordion,{title:`Dropdowns loading huge option lists`,icon:`list`,id:`dropdowns-loading-huge-option-lists`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: A dropdown shows every record from a table as an option. With many records, that single request alone is heavy.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Convert it into a search-style picker — only fetch matching records after the user types. Alternatively, cache the option list.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Dropdowns should not load all options upfront. Switch to a keyword search that fetches matching records on input, with debounce applied.”`]})})]}),_jsxs(Accordion,{title:`Cascading selectors chaining requests`,icon:`sitemap`,id:`cascading-selectors-chaining-requests`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Choosing one field triggers a load for the next level’s options. Multi-level cascades rack up several requests per interaction.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Preload the related data once and filter locally, or cache cascade data after the first load.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Cache cascading selector option data locally after loading. When the user changes a parent option, filter from the cache instead of re-requesting.”`]})})]}),_jsxs(Accordion,{title:`Re-renders triggering duplicate requests`,icon:`repeat`,id:`re-renders-triggering-duplicate-requests`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Poor state management causes components to re-fetch data on every render.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Trigger data fetching on specific events (initial mount, explicit user action), not on every render. Use caching as a safety net.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Only fetch data on first page load or explicit user actions. Do not re-fetch on re-renders — use cached data instead.”`]})})]})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Pagination \u0026 batching — shrink per-request payloads`})}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Lists or tables without pagination`,icon:`table-list`,id:`lists-or-tables-without-pagination`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Loading all records at once produces a flood of API calls when the dataset grows.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Paginate. Only fetch the current page’s data.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Show 20 rows per page. Only load the next page when the user navigates to it. Do not load everything at once.”`]})})]}),_jsxs(Accordion,{title:`Per-row fetching for linked data (N+1)`,icon:`link`,id:`per-row-fetching-for-linked-data-n-1`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: After loading a list, you fetch linked-table details for each record one at a time. Loading 50 projects and then 50 owner lookups = 50 extra requests in an instant.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Fetch all linked data in one batch, not row by row.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “When loading a list, batch-fetch all linked data in a single request. Do not loop through records to fetch their linked information individually.”`]})})]}),_jsxs(Accordion,{title:`Per-row writes during bulk updates`,icon:`pen-to-square`,id:`per-row-writes-during-bulk-updates`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Bulk-updating multiple records by sending one update request per record instead of a single batch request.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Use the batch update API to submit all changes in one call.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “For bulk operations, merge multiple record changes into a single batch request. Do not send one update per record.”`]})})]}),_jsxs(Accordion,{title:`API calls inside loops`,icon:`rotate`,id:`api-calls-inside-loops`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: A `,_jsx(_components.code,{children:`for`}),` loop processes records one at a time, calling the API each iteration.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Collect all the IDs first, then issue a single batch request.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Do not call the API inside a loop. Collect all required IDs first, then issue a single batch request.”`]})})]})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Debounce \u0026 throttle — lower request frequency`})}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Search or filters without debounce`,icon:`magnifying-glass`,id:`search-or-filters-without-debounce`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Every keystroke in a search box fires a request. Typing a 4-character query produces 4 requests.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Debounce the input — wait 300–500 ms after the user stops typing before firing the request.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Debounce the search input. Only send a request 300 ms after the user stops typing. Do not send requests mid-typing.”`]})})]}),_jsxs(Accordion,{title:`Rapid repeated user actions`,icon:`hand-pointer`,id:`rapid-repeated-user-actions`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Rapid-fire submit clicks, quick filter toggling, fast pagination — each action fires a request immediately.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Apply debounce or throttle. Disable submit buttons until the request completes to prevent double-submits.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Disable the submit button after click and re-enable it once the request resolves. Debounce filter changes so rapid changes within 300 ms fire only one request.”`]})})]}),_jsxs(Accordion,{title:`Overly aggressive form auto-save`,icon:`floppy-disk`,id:`overly-aggressive-form-auto-save`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Every field change saves immediately. Filling out a form can trigger a dozen writes.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Switch to explicit save on button click, or debounce auto-save so it fires once after a pause in editing.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Do not save on every field change. Save on explicit button click, or auto-save once after the user has paused editing for 2 seconds.”`]})})]}),_jsxs(Accordion,{title:`Polling intervals that are too short`,icon:`clock`,id:`polling-intervals-that-are-too-short`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Data refreshes every few seconds, producing sustained high-frequency traffic.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Lengthen the poll interval to something reasonable (30 seconds or more), or switch to manual refresh.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Set the auto-refresh interval to 60 seconds. Add a manual refresh button so users can pull the latest data on demand.”`]})})]}),_jsxs(Accordion,{title:`Multiple components polling independently`,icon:`timer`,id:`multiple-components-polling-independently`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: Several components on a page each set up their own poll timer. The combined load easily exceeds the limit.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: Centralize polling. Run one periodic fetch, then fan the result out to every component that needs it.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “Don’t let each component set up its own poll timer. Use a single refresh mechanism that fetches everything on a schedule and distributes the data to the components.”`]})})]})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Rendering compatibility — reduce preview errors`})}),`\n`,_jsx(AccordionGroup,{children:_jsxs(Accordion,{title:`Charts, maps, or browser-only components fail in preview`,icon:`chart-line`,id:`charts-maps-or-browser-only-components-fail-in-preview`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scenario`}),`: The page uses charts, maps, or libraries that depend on `,_jsx(_components.code,{children:`window`}),`, DOM measurements, or other browser-only APIs, and the preview shows errors, a blank screen, or hydration mismatches.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix`}),`: These components are often safer to load in the browser instead of rendering them directly on the server. If preview issues persist, explicitly ask the AI to switch them to a browser-only loading pattern.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reference prompt`}),`: “This component depends on the browser environment. Load it only on the client to avoid preview rendering errors or hydration mismatches.”`]})})]})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`AI can make mistakes. Please double-check responses.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"App Builder tips: plan, prompt and troubleshoot","description":"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.","sidebarTitle":"App Builder Best Practices","href":"/en/basic/ai/app-builder-practical-guide"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Building Tips","slug":"building-tips","depth":2,"children":[{"title":"1. Define data first","slug":"1-define-data-first","depth":3,"children":[]},{"title":"2. Plan before you build","slug":"2-plan-before-you-build","depth":3,"children":[]},{"title":"3. Start small","slug":"3-start-small","depth":3,"children":[]},{"title":"4. Be specific, not abstract","slug":"4-be-specific-not-abstract","depth":3,"children":[]},{"title":"5. Diagnose before fixing","slug":"5-diagnose-before-fixing","depth":3,"children":[]},{"title":"6. Lean on version rollbacks","slug":"6-lean-on-version-rollbacks","depth":3,"children":[]}]},{"title":"FAQ","slug":"faq","depth":2,"children":[{"title":"App Builder only supports Next.js","slug":"app-builder-only-supports-next-js","depth":3,"children":[]},{"title":"Handling 429 errors","slug":"handling-429-errors","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/teablecn/00e327112fed3559/changelog-toc.js","/_mintlify/custom/teablecn/52b6025e1e6e9c39/language-route.js","/_mintlify/custom/teablecn/58987b414332357e/help-link-tracking.js"],"subdomain":"teablecn","siteName":"Teable","title":"App Builder tips: plan, prompt and troubleshoot - Teable","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/basic/ai/app-builder-practical-guide","matchLevel":0},"zh":{"href":"/zh/basic/ai/app-builder-practical-guide","matchLevel":1},"ru":{"href":"/ru/basic/ai/app-builder-practical-guide","matchLevel":1},"de":{"href":"/de/basic/ai/app-builder-practical-guide","matchLevel":1},"fr":{"href":"/fr/basic/ai/app-builder-practical-guide","matchLevel":1},"es":{"href":"/es/basic/ai/app-builder-practical-guide","matchLevel":1},"it":{"href":"/it/basic/ai/app-builder-practical-guide","matchLevel":1},"ja":{"href":"/ja/basic/ai/app-builder-practical-guide","matchLevel":1},"tr":{"href":"/tr/basic/ai/app-builder-practical-guide","matchLevel":1},"uk":{"href":"/uk/basic/ai/app-builder-practical-guide","matchLevel":1},"ar":{"href":"/ar/basic/ai/app-builder-practical-guide","matchLevel":1}}},"lastModified":"2026-10-21T12:04:22.140Z","gitLastModified":"2026-10-21T12:01:58.000Z","originalFileLocation":"en/basic/ai/app-builder-practical-guide.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.\">\u003cmeta data-mint-head name=\"keywords\" content=\"database, app builder, AI, no-code, low-code, Airtable alternative, PostgreSQL, automation\">\u003cmeta data-mint-head name=\"application-name\" content=\"Teable\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"App Builder tips: plan, prompt and troubleshoot - Teable\">\u003cmeta data-mint-head property=\"og:description\" content=\"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Teable\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://teable.ai/assets/images/og-image.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"App Builder tips: plan, prompt and troubleshoot - Teable\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://teable.ai/assets/images/og-image.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/teablecn/rUjbOrtkw4E-Xgfe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Teable\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#131415\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/basic/ai/app-builder-practical-guide.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://help.teable.ai/zh/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://help.teable.ai/ru/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://help.teable.ai/de/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://help.teable.ai/fr/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://help.teable.ai/es/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://help.teable.ai/it/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://help.teable.ai/ja/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://help.teable.ai/tr/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"uk\" href=\"https://help.teable.ai/uk/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://help.teable.ai/ar/basic/ai/app-builder-practical-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.teable.ai/#organization\",\"name\":\"Teable\",\"url\":\"https://help.teable.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/teablecn/Sov59EnEPMakaGyj/images/teable-logo-full.png?fit=max\u0026auto=format\u0026n=Sov59EnEPMakaGyj\u0026q=85\u0026s=24e1fe49258a9a8f76eaec5792623926\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.teable.ai#website\",\"name\":\"Teable\",\"url\":\"https://help.teable.ai\",\"publisher\":{\"@id\":\"https://help.teable.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide#webpage\",\"url\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide\",\"name\":\"App Builder tips: plan, prompt and troubleshoot\",\"description\":\"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.\",\"dateModified\":\"2026-10-21T12:01:58.000Z\",\"isPartOf\":{\"@id\":\"https://help.teable.ai#website\"},\"breadcrumb\":{\"@id\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI\",\"item\":\"https://help.teable.ai/en/basic/ai/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"App Builder\",\"item\":\"https://help.teable.ai/en/basic/ai/app-builder\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"App Builder tips: plan, prompt and troubleshoot\",\"item\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide#article\",\"headline\":\"App Builder tips: plan, prompt and troubleshoot\",\"name\":\"App Builder tips: plan, prompt and troubleshoot\",\"description\":\"Prepare your data model, plan before building and improve an app in small steps. Use precise prompts, diagnose errors and roll back versions when needed.\",\"url\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide\",\"mainEntityOfPage\":{\"@id\":\"https://help.teable.ai/en/basic/ai/app-builder-practical-guide#webpage\"},\"image\":\"https://teable.ai/assets/images/og-image.png\",\"dateModified\":\"2026-10-21T12:01:58.000Z\",\"publisher\":{\"@id\":\"https://help.teable.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://help.teable.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Teable\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Teable\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/basic/ai/app-builder-practical-guide.md","siteName":"Teable","nav":{"global":null,"languages":[{"language":"en","banner":{"content":"🚀 Share your projects as templates. See our [changelog](/en/changelog#nov-20-2026) for details.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Support"}]},"tabs":[{"tab":"Docs","groups":[{"group":"Start here","pages":[{"title":"Documentation: AI, tables, APIs and self-hosting","sidebarTitle":"Teable documentation","href":"/en"}]},{"group":"AI","pages":[{"title":"AI features: chat, app building and automation","sidebarTitle":"AI capabilities in Teable","href":"/en/basic/ai/overview"},{"title":"AI Chat: analyze data and work with your tables","sidebarTitle":"AI Chat","href":"/en/basic/ai/ai-chat"},{"title":"Artifacts: save, revise, and share AI-generated reports and charts","sidebarTitle":"Artifacts","href":"/en/basic/ai/artifact"},{"title":"AI routines: scheduled and event-triggered tasks","sidebarTitle":"Routine","href":"/en/basic/ai/routine"},{"group":"App Builder","pages":[{"title":"App Builder: create and publish AI-built apps","description":"Turn project tables into a web app with prompts. Edit and preview the app, configure login and a custom domain, then publish or roll back a version.","sidebarTitle":"App Builder","href":"/en/basic/ai/app-builder"},{"title":"App Builder tips: plan, prompt and troubleshoot","sidebarTitle":"App Builder Best Practices","href":"/en/basic/ai/app-builder-practical-guide"},{"title":"Track clinical study startup and site readiness","description":"Track clinical study startup tasks, research-site readiness, owners and deadlines in linked tables. Add status views and reminders, then test the workflow with one site.","sidebarTitle":"Study startup and site readiness","href":"/en/basic/ai/examples/study-startup"}]},{"title":"AI fields: summarize, classify and generate values","sidebarTitle":"AI Fields","href":"/en/basic/field/ai/ai-field"},{"group":"Connect \u0026 Migrate Everything","pages":[{"title":"Connect Everything: migrate external data","sidebarTitle":"Connect \u0026 Migrate Everything","href":"/en/basic/ai/connect-everything"},{"title":"Migrate Airtable data to Teable","sidebarTitle":"Migrate Airtable","href":"/en/basic/ai/connect-everything/migrate-airtable"},{"title":"Migrate Baserow data to Teable","sidebarTitle":"Migrate Baserow","href":"/en/basic/ai/connect-everything/migrate-baserow"},{"title":"Migrate SmartSuite data to Teable","sidebarTitle":"Migrate SmartSuite","href":"/en/basic/ai/connect-everything/migrate-smartsuite"},{"title":"Migrate NocoDB data to Teable","sidebarTitle":"Migrate NocoDB","href":"/en/basic/ai/connect-everything/migrate-nocodb"},{"title":"Migrate Jira data to Teable","sidebarTitle":"Migrate Jira","href":"/en/basic/ai/connect-everything/migrate-jira"},{"title":"Migrate monday.com data to Teable","sidebarTitle":"Migrate monday.com","href":"/en/basic/ai/connect-everything/migrate-monday"},{"title":"Migrate ClickUp data to Teable","sidebarTitle":"Migrate ClickUp","href":"/en/basic/ai/connect-everything/migrate-clickup"},{"title":"Migrate Smartsheet data to Teable","sidebarTitle":"Migrate Smartsheet","href":"/en/basic/ai/connect-everything/migrate-smartsheet"},{"title":"Migrate Glide data to Teable","sidebarTitle":"Migrate Glide","href":"/en/basic/ai/connect-everything/migrate-glide"},{"title":"Migrate AppSheet data to Teable","sidebarTitle":"Migrate AppSheet","href":"/en/basic/ai/connect-everything/migrate-appsheet"},{"title":"Migrate Asana data to Teable","sidebarTitle":"Migrate Asana","href":"/en/basic/ai/connect-everything/migrate-asana"},{"title":"Connect APIs, databases and other data sources","sidebarTitle":"Connect \u0026 Migrate More Sources","href":"/en/basic/ai/connect-everything/more-sources"}]},{"title":"Manage connections, API keys and secrets","sidebarTitle":"Credentials and Integrations","href":"/en/basic/credential"},{"title":"Connect AI agents with Teable Skill or MCP","sidebarTitle":"Connect AI Agents to Teable","href":"/en/basic/ai/teable-skill"},{"title":"Custom AI models: add providers and test access","sidebarTitle":"Custom AI Model","href":"/en/basic/ai/custom-model"}]},{"group":"Space","pages":[{"title":"Create and manage spaces","sidebarTitle":"Manage spaces","href":"/en/basic/space"},{"title":"Invite and manage space collaborators","sidebarTitle":"Space Invitation","href":"/en/basic/space/space-invite"},{"title":"Invite collaborators to a specific project","sidebarTitle":"Project Invitation","href":"/en/basic/space/base-invite"},{"title":"Space and project permission levels","sidebarTitle":"Collaboration Permission Details","href":"/en/basic/space/space-permission"},{"title":"Cloud billing: plans, credits, usage and invoices","sidebarTitle":"Billing \u0026 Subscription","href":"/en/basic/space/billing"}]},{"group":"Automation","pages":[{"title":"Build automations with triggers and actions","sidebarTitle":"Build automations","href":"/en/basic/automation"},{"group":"Triggers","pages":[{"title":"Record Matches Conditions trigger: detect state changes","sidebarTitle":"When record matches conditions","href":"/en/basic/automation/trigger/records/record-matches-conditions"},{"title":"Record Created trigger: automate new rows","sidebarTitle":"When record created","href":"/en/basic/automation/trigger/records/record-created"},{"title":"Record Updated trigger: watch field changes","sidebarTitle":"When record updated","href":"/en/basic/automation/trigger/records/record-updated"},{"title":"Form Submitted trigger: process new responses","sidebarTitle":"When form submitted","href":"/en/basic/automation/trigger/forms/form-submitted"},{"title":"Scheduled Time trigger: recurring or one-time runs","sidebarTitle":"At scheduled time","href":"/en/basic/automation/trigger/external/scheduled-time"},{"title":"Button Click trigger: run an automation from a record","sidebarTitle":"When button clicked","href":"/en/basic/automation/trigger/forms/button-click"},{"title":"Webhook trigger: start an automation with HTTP POST","sidebarTitle":"When webhook received","href":"/en/basic/automation/trigger/external/webhook-received"},{"title":"Connector Event trigger: react to app events","sidebarTitle":"When connector event received","href":"/en/basic/automation/trigger/external/connector-event"},{"group":"When email received","pages":[{"title":"Email Received trigger: connect a mailbox","sidebarTitle":"When email received overview","href":"/en/basic/automation/trigger/email/email-received-overview"},{"title":"Gmail IMAP setup and app passwords","sidebarTitle":"Set up Gmail IMAP","href":"/en/basic/automation/trigger/email/gmail-imap"}]}]},{"group":"Actions","pages":[{"group":"Build with AI (recommended)","pages":[{"title":"Generate automation scripts with AI","href":"/en/basic/automation/actions/ai/ai-script"}]},{"group":"Build manually","pages":[{"title":"Create record action in an automation","sidebarTitle":"Create record","href":"/en/basic/automation/actions/records/create-record"},{"title":"Update record action in an automation","sidebarTitle":"Update record","href":"/en/basic/automation/actions/records/update-record"},{"title":"Get records action: filters and pagination","sidebarTitle":"Get records","href":"/en/basic/automation/actions/records/get-records"},{"group":"Send email","pages":[{"title":"Send email action: recipients, content and SMTP","sidebarTitle":"Send email overview","href":"/en/basic/automation/actions/communication/send-email-overview"},{"title":"Custom SMTP for automation email actions","sidebarTitle":"Set up SMTP and sender","href":"/en/basic/automation/actions/communication/smtp-sender"}]},{"title":"HTTP request action: call an external API","sidebarTitle":"HTTP request","href":"/en/basic/automation/actions/logic/http-request"},{"title":"AI generate action: text and structured output","sidebarTitle":"AI generate","href":"/en/basic/automation/actions/ai/ai-generate"},{"title":"Cross-project data access in automations","sidebarTitle":"Cross-project access","href":"/en/basic/automation/actions/records/cross-base"},{"title":"Loop action: process arrays in batches","sidebarTitle":"Loop (batch)","href":"/en/basic/automation/actions/logic/loop-run"},{"title":"Conditional logic: branch automations","sidebarTitle":"Conditional logic","href":"/en/basic/automation/actions/manual/conditional-logic"},{"title":"Run script action: custom JavaScript automations","sidebarTitle":"Write automation scripts","href":"/en/basic/automation/ai/scripting/runscript"}]}]},{"group":"Examples","pages":[{"title":"Auto-create records on a recurring schedule","href":"/en/basic/automation/examples/recurring-records"},{"title":"Run different actions based on record values","href":"/en/basic/automation/examples/conditional-actions"},{"title":"Batch-process records with loop","href":"/en/basic/automation/examples/batch-loop"},{"title":"Avoid unwanted triggers with filters and watch fields","href":"/en/basic/automation/examples/prevent-unwanted-triggers"},{"title":"Auto-record the time when a status changes","href":"/en/basic/automation/examples/timestamp-status"},{"title":"Push notifications to Slack, Discord, or Teams","href":"/en/basic/automation/examples/push-notifications"},{"title":"Send deadline reminders before tasks are due","href":"/en/basic/automation/examples/deadline-reminders"},{"title":"Generate and send a daily email digest with AI","href":"/en/basic/automation/examples/ai-email-digest"},{"title":"Auto-classify new form entries with AI","href":"/en/basic/automation/examples/ai-classify-forms"},{"title":"Keep records in sync across multiple projects","href":"/en/basic/automation/examples/cross-base-sync"},{"title":"Build automations programmatically with the API","href":"/en/basic/automation/examples/api-automation"}]}]},{"group":"Project","pages":[{"title":"Create, share and migrate projects","sidebarTitle":"Create and manage projects","href":"/en/basic/base"},{"group":"Table","pages":[{"title":"Create, organize and share tables","sidebarTitle":"Create and manage tables","href":"/en/basic/table"},{"title":"Import CSV, Excel, Airtable and Google Sheets data","sidebarTitle":"Import","href":"/en/basic/table/import"},{"title":"Export a table or view to CSV","sidebarTitle":"Export","href":"/en/basic/table/export"}]},{"group":"Field","pages":[{"title":"Field types: choose, add and manage columns","sidebarTitle":"Fields and field types","href":"/en/basic/field"},{"title":"AI fields: summarize, classify and generate values","sidebarTitle":"AI Fields","href":"/en/basic/field/ai/ai-field"},{"group":"Basic Field","pages":[{"title":"Single line text field: names, IDs and links","sidebarTitle":"Single line text","href":"/en/basic/field/single-line-text"},{"title":"Long text field: multiline notes and Markdown","sidebarTitle":"Long text","href":"/en/basic/field/long-text"},{"title":"Number field: decimals, currency and percentages","sidebarTitle":"Number","href":"/en/basic/field/number"},{"title":"Single select field: statuses and option management","sidebarTitle":"Single select","href":"/en/basic/field/single-select"},{"title":"Multiple select field: tags and option management","sidebarTitle":"Multiple select","href":"/en/basic/field/multiple-select"},{"title":"Date field: formats, time zones and defaults","sidebarTitle":"Date","href":"/en/basic/field/date"},{"title":"Rating field: visual scores for records","sidebarTitle":"Rating","href":"/en/basic/field/rating"},{"title":"Checkbox field: track yes/no and completion","sidebarTitle":"Checkbox","href":"/en/basic/field/checkbox"},{"title":"Attachment field: upload and download files","sidebarTitle":"Attachment","href":"/en/basic/field/attachment"}]},{"group":"Advanced Field","pages":[{"group":"Formula","pages":[{"title":"Formula field: calculations and field references","sidebarTitle":"Formula","href":"/en/basic/field/formula"},{"title":"Formula syntax: values, field references and operators","sidebarTitle":"Formula Grammar","href":"/en/basic/field/formula/grammar"},{"title":"Formula function reference with syntax and examples","mode":"wide","sidebarTitle":"Function Cheat Sheet","href":"/en/basic/field/formula/cheat-sheet"}]},{"title":"Link to record field: connect records across tables","sidebarTitle":"Link to record","href":"/en/basic/field/link"},{"title":"Rollup field: summarize linked records","sidebarTitle":"Rollup","href":"/en/basic/field/rollup"},{"title":"Lookup field: reference linked table values","sidebarTitle":"Lookup","href":"/en/basic/field/lookup"},{"title":"Conditional rollup: count and summarize matches","sidebarTitle":"Conditional rollup","href":"/en/basic/field/conditional-rollup"},{"title":"Conditional lookup: find matching table records","sidebarTitle":"Conditional lookup","href":"/en/basic/field/conditional-lookup"},{"title":"User field: assign members to records","sidebarTitle":"User field","href":"/en/basic/field/user"},{"title":"Created by field: track record creators","sidebarTitle":"Created by","href":"/en/basic/field/created-by"},{"title":"Last modified by field: track record editors","sidebarTitle":"Last modified by","href":"/en/basic/field/last-modified-by"},{"title":"Created time field: track record creation dates","sidebarTitle":"Created time","href":"/en/basic/field/created-time"},{"title":"Last modified time field: track record changes","sidebarTitle":"Last modified time","href":"/en/basic/field/last-modified-time"},{"title":"Auto number field: generate record sequences","sidebarTitle":"Auto number","href":"/en/basic/field/auto-number"},{"group":"Button","pages":[{"title":"Button field: trigger an automation","sidebarTitle":"Button","href":"/en/basic/field/button"},{"title":"Button automation example: convert sales leads","sidebarTitle":"Button Practical Guide","href":"/en/basic/field/button-practical-guide"}]}]},{"group":"Common","pages":[{"title":"Field formatting: numbers, currency and dates","sidebarTitle":"Formatting","href":"/en/basic/field/common/formatter"},{"title":"Field display: email links and number charts","sidebarTitle":"Interactive Display","href":"/en/basic/field/common/show-as"},{"title":"Single-value and multiple-value fields","sidebarTitle":"Single Value and Multiple Values","href":"/en/basic/field/common/is-multiple-value"}]}]},{"group":"Records","pages":[{"title":"Create, edit and delete records","sidebarTitle":"Create and manage records","href":"/en/basic/record"},{"title":"Record comments: discuss data and mention teammates","sidebarTitle":"Comments","href":"/en/basic/record/comment"},{"title":"Record history: review data changes and editors","sidebarTitle":"Record history","href":"/en/basic/record/record-history"},{"title":"Archive records and restore deleted table data","sidebarTitle":"Archive and Trash","href":"/en/basic/record/archive-trash"}]},{"group":"View","pages":[{"title":"Grid view: edit, organize and review table data","sidebarTitle":"Grid","href":"/en/basic/view/grid"},{"title":"Form view: collect responses into a table","sidebarTitle":"Form","href":"/en/basic/view/form"},{"title":"Kanban view: group records and track progress","sidebarTitle":"Kanban","href":"/en/basic/view/kanban"},{"title":"Gallery view: image cards and record details","sidebarTitle":"Gallery","href":"/en/basic/view/gallery"},{"title":"Calendar view: schedule records by date","sidebarTitle":"Calendar","href":"/en/basic/view/calendar"},{"title":"Filter, group, sort and share a view","sidebarTitle":"View Toolbar","href":"/en/basic/view/toolbar"}]},{"title":"Turn a project into a template and publish it","sidebarTitle":"Make a template","href":"/en/basic/template"}]},{"group":"Authority Matrix","pages":[{"group":"Authority Matrix","pages":[{"title":"Authority Matrix: roles and data access permissions","sidebarTitle":"Roles and access permissions","href":"/en/basic/authority-matrix"},{"title":"Authority Matrix example: sales team permissions","sidebarTitle":"Authority Matrix Guidelines","href":"/en/basic/authority-matrix/authority-matrix-practical-guide"}]}]},{"group":"SSO","pages":[{"title":"Space SSO: verify domains and connect an identity provider","sidebarTitle":"Single Sign-On (SSO)","href":"/en/basic/sso/overview"},{"title":"Set up Azure Entra ID single sign-on","sidebarTitle":"Azure Entra ID SSO","href":"/en/basic/sso/azure-entra-id"},{"title":"Set up Okta single sign-on","sidebarTitle":"Okta SSO","href":"/en/basic/sso/okta"},{"title":"Set up Google Workspace single sign-on","sidebarTitle":"Google Workspace SSO","href":"/en/basic/sso/google-workspace"},{"title":"Set up Auth0 single sign-on","sidebarTitle":"Auth0 SSO","href":"/en/basic/sso/auth0"},{"title":"Set up OneLogin single sign-on","sidebarTitle":"OneLogin SSO","href":"/en/basic/sso/onelogin"},{"title":"Set up Authentik single sign-on","sidebarTitle":"Authentik SSO","href":"/en/basic/sso/authentik"}]},{"group":"Comparison","pages":[{"title":"Teable vs Excel: database and spreadsheet workflows","sidebarTitle":"Teable vs Excel","href":"/en/compare/teable-vs-excel"}]}]},{"tab":"Self-hosted","pages":[{"title":"Self-hosted","href":"/en/deploy/activate"}]},{"tab":"API","pages":[{"title":"API","href":"/en/api-doc/overview"}]},{"tab":"Security","pages":[{"title":"Security","href":"/en/basic/security"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/en/changelog"}]}]},{"language":"zh","banner":{"content":"🚀 把项目做成模板分享。查看[更新日志](/zh/changelog#2026-11-20)了解详情。","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"支持"}]},"pages":[{"title":"zh","href":"/zh/basic/ai/app-builder-practical-guide"}]},{"language":"ru","banner":{"content":"🚀 Делитесь проектами как шаблонами. Подробнее в [журнале изменений](/ru/changelog#20-ноября-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Поддержка"}]},"pages":[{"title":"ru","href":"/ru/basic/ai/app-builder-practical-guide"}]},{"language":"de","banner":{"content":"🚀 Teile deine Projekte als Vorlagen. Details im [Änderungsprotokoll](/de/changelog#20-november-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Support"}]},"pages":[{"title":"de","href":"/de/basic/ai/app-builder-practical-guide"}]},{"language":"fr","banner":{"content":"🚀 Partagez vos projets sous forme de modèles. Consultez notre [journal des modifications](/fr/changelog#20-novembre-2026) pour en savoir plus.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Assistance"}]},"pages":[{"title":"fr","href":"/fr/basic/ai/app-builder-practical-guide"}]},{"language":"es","banner":{"content":"🚀 Comparte tus proyectos como plantillas. Consulta el [registro de cambios](/es/changelog#20-de-noviembre-de-2026) para más detalles.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Soporte"}]},"pages":[{"title":"es","href":"/es/basic/ai/app-builder-practical-guide"}]},{"language":"it","banner":{"content":"🚀 Condividi i tuoi progetti come modelli. Scopri i dettagli nel [registro delle modifiche](/it/changelog#20-novembre-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Supporto"}]},"pages":[{"title":"it","href":"/it/basic/ai/app-builder-practical-guide"}]},{"language":"ja","banner":{"content":"🚀 プロジェクトをテンプレートとして共有。詳しくは[更新履歴](/ja/changelog#2026年11月20日)をご覧ください。","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"サポート"}]},"pages":[{"title":"ja","href":"/ja/basic/ai/app-builder-practical-guide"}]},{"language":"tr","banner":{"content":"🚀 Projelerinizi şablon olarak paylaşın. Ayrıntılar için [değişiklik günlüğüne](/tr/changelog#20-kasım-2026) bakın.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Destek"}]},"pages":[{"title":"tr","href":"/tr/basic/ai/app-builder-practical-guide"}]},{"language":"uk","banner":{"content":"🚀 Діліться проєктами як шаблонами. Докладніше в [журналі змін](/uk/changelog#20-листопада-2026).","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"Підтримка"}]},"pages":[{"title":"uk","href":"/uk/basic/ai/app-builder-practical-guide"}]},{"language":"ar","banner":{"content":"🚀 شارك مشاريعك كقوالب. راجع [سجل التغييرات](/ar/changelog#20-نوفمبر-2026) لمعرفة التفاصيل.","dismissible":true},"navbar":{"links":[{"icon":"comment","href":"https://community.teable.ai/","label":"الدعم"}]},"pages":[{"title":"ar","href":"/ar/basic/ai/app-builder-practical-guide"}]}]},"basePath":"","title":"App Builder tips: plan, prompt and troubleshoot - Teable","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}