# Manage your account Source: https://docs.buildai.space/account/managing-your-account View your plan, track usage, manage billing, and update your account settings. Managing your account settings is straightforward and puts you in full control of your builder messages, AI credits, and subscription plan. This guide will walk you through how to locate your account settings, understand the features you can manage, and stay informed about billing. *** ## 1. How to Find Account Settings To access your account settings: * Look for your account icon or initial in the **bottom-left corner** of the screen. * Click on it to open the menu. * Select **Account** from the options. Here’s an updated illustration showing exactly where to find the **Account** option in the menu: ![Account menu with the Account option highlighted](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/f1cb00f8-0226-4576-aa70-26168af652db.jpg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=WfmpqlNGKDeqxFy34raiMLplCOCHqKUNP5c2pHSNgQUFIo5TO6T%2B0lTJDpxBWa4MFRayGvUSqK7UjufImu%2BbTwaOBqdKTRTDwXNjIf%2FUOTvD9PdOkp2dDZ%2Fc%2BK0blHlWYXSiReXGMPlLVUMBLBlFYybWDj7lKMPaE%2BZwKkmLqJ7YpvfwIyqamG1LG58rwxINcBjh6uSYutIV3xPJWUjoGr2GZOx%2Bcv2W%2BR5CxhM5k6kmMLavVGzTN9kmJpT%2F%2FBq9WXQ9ADEN5nwDXVWvToRrxzpTDnMinSwzvNPFU6GHvM9VFEJaoq02BCX42rYjQGBvKFWdRX90ynCIefz7xJAE3g%3D%3D) *** ## 2. What You Can Manage in Account Settings Once you open your **Account Settings** page, you’ll find several key features: * **Email:** Your registered email address. * **Plan:** Your current subscription plan, with options to **Change plan** or **Cancel plan**. * **Usage Details:** * **Monthly Builder Chat Messages:** Displays how many builder messages you’ve sent out of your monthly quota. * **Monthly AI Credits:** Shows your AI credits used and those remaining. * **Danger Zone:** A section where you can permanently delete your account if you wish. Here’s a snapshot of the Account Settings page for easy reference: ![Account Settings page showing email, plan details, usage, and danger zone](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/b2685d62-dbb2-4fd3-a243-306c409a7ce8.jpg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=LY1QHU88jPAdHfhvR2xFh3EDVs4%2BUPyY74bWgeo59F0LCQRxY8WmFFDyvrtJI8MFayhc0NlqVrXLAsmklE2pJqBE9yyHCpGm1iqTKh%2BUUiH7XmHfcEzlbemKgdGjsVM9ChkbatWgRFEV765A%2FuXJXxWiMAt%2FKquxXSiXWqyytjcVISuR8eRBpWN4l5eC3Pw14AbbEtyds8GojhWehyivpfJesQXO3pGoyp78GysWk52Emw2F27H0LE7C4Q%2FV5P9UiKr1SnwYniicBTPWgFOAxnSOm0%2BsDxtduSB8aAHkzn3%2FefIlVa6usksWJ0SzChyLpHIphgTf9k81rbtNqRKPoA%3D%3D) *** ## 3. Key Details to Remember ### Builder Messages Builder messages are how you communicate with our AI to build or refine your app. Each message you send counts toward your monthly builder message quota. ### AI Credits AI credits power the AI features that assist your users. The number of credits used depends on the complexity and frequency of AI interactions. *** ## 4. Billing and Invoice Management All billing activities—including viewing invoices, payment history, and subscription changes—are managed through **Gumroad**. You can access your billing information anytime by visiting: [https://gumroad.com/](https://gumroad.com/) *** By following these steps, you can easily manage your account settings, monitor your usage, and update your subscription plan whenever needed. If you have any questions or need assistance, don’t hesitate to reach out to our support team via email. *** # What are AI credits? Source: https://docs.buildai.space/account/what-are-ai-credits Understand how AI credits power your app's AI features and how usage is calculated. AI credits are used when your app uses AI to help your users. Different AI features use different amounts of credits. # Visual editor Source: https://docs.buildai.space/building-apps/app-visual-editor Customize your app's design, layout, and styles visually without writing code. The App Visual Editor is a powerful, user-friendly tool that lets you select and edit any area of your app directly—without consuming credits or needing to use the builder chat. Best of all, it’s available on **desktop**, making it easy to visually customize your app on a larger screen with precision. Follow this straightforward step-by-step guide to start editing your app visually and effortlessly! ## Step 1: Activate Visual Edit Mode Begin by opening your app’s builder interface on your desktop. Look for the **finger icon** located at the bottom left corner of the screen. Clicking this icon will activate the Visual Edit Mode, enabling you to click on and edit elements directly within the app preview. ![Go to builder and click the finger button](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2Fb2e3e4df-6c45-4057-8c3d-c62a2f2bc8fa.jpg?alt=media\&token=329135ec-be7c-469d-8634-5583cbaff9b8) ## Step 2: Select the Area You Want to Edit With Visual Edit Mode active, simply click on the part of your app preview you want to modify. This action opens the editing options specific to that element, allowing you to customize it instantly. ![Click area in app preview you would like to edit](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F4734bc47-fc9a-4eb5-bd31-54c13d36e0c5.jpg?alt=media\&token=7a9891c9-a1cb-49bd-87fc-68c1a2a03c24) ## Step 3: Use the Item Edit Menu Once you've selected an element, the item edit menu will appear on the **left side** of your screen. Here, you can adjust the content such as text, colors, fonts, sizes, spacing, and other advanced settings to tailor the element exactly how you want it. ![Item edit menu is opened in left side allowing you to edit item content, colors, font, size, spacing and more advanced abilities](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F0fd41f78-0334-42dc-85eb-e7eda75d457e.jpg?alt=media\&token=3d6ce6df-7f51-4a2b-bd21-fb9b9c243576) ## Step 4: Explore More Editing Abilities Dig deeper into the advanced options to fine-tune your design. You can modify font size, weight, decoration, alignment, text transformation, spacing, and other styling features to perfectly customize your app’s visual elements. ![More abilities as font size, spacing and more](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F7e28ef16-ea0d-484c-a502-dd8d6c85b888.png?alt=media\&token=8c19e873-2fdb-4cca-9524-35b479deb4cc) ## Summary * The App Visual Editor is available on **desktop**, providing a convenient workspace to edit your app visually. * Click the **finger icon** at the bottom left corner to activate Visual Edit Mode. * Click any element in your app preview to open its editing options. * Use the left-side menu to adjust content, colors, fonts, sizes, spacing, and more. * Explore advanced styling options to customize your app’s look precisely and efficiently. With the desktop App Visual Editor, you have all the tools you need to make your app look exactly how you envision—quickly, intuitively, and without any additional costs. Enjoy creating your perfect app experience with ease! # AI Chat Assistant Source: https://docs.buildai.space/building-apps/how-to-add-a-chatbot-to-your-app-a-step-by-step-guide Add a chat assistant that helps your users get answers, take actions, and navigate your app. Integrating a chat assistant into your app can significantly enhance user engagement by providing instant answers, personalized assistance, and even performing specific tasks directly within the app interface. This guide will help you clearly communicate your Chat Assistant requirements to your app builder, covering its purpose, placement, appearance, and activation method. *** ## Step 1: Define the Chat Assistant's Purpose and Capabilities Begin by specifying what you want your Chat Assistant to do. Chat Assistants can be designed to: * **Answer user questions** related to your app’s features, services, or any other relevant information. * **Perform specific actions** within the app, such as updating profile images, modifying settings, or guiding users through certain workflows. **Example request:** > "Please add a Chat Assistant that can make changes to the generated profile image based on user requests." This means users can interact with the Chat Assistant to ask for modifications like changing the color of a jacket in their profile photo or adjusting the smile size, creating a convenient and interactive experience. *** ## Step 2: Specify Chat Assistant and Branding Decide where the Chat Assistant icon should appear on your app’s interface and how it should be visually represented to maintain your app’s branding. * **Placement:** A common and user-friendly spot is the bottom right corner of the screen. * **Appearance:** Use your own logo or icon, ideally shaped (e.g., circular) to keep it clean and consistent with your app’s design. **Example request:** > "Add the Chat Assistant icon in the bottom right corner of the app, using my attached circular logo for its appearance." Here’s how you might visually communicate this to your builder when requesting: ![Asking builder chat to add the chatbot](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F58a4556f-94fd-4c8e-8858-7e7d99909462.jpg?alt=media\&token=5fd93fb6-1941-4999-bc9a-0d018bcb943b) After adding the Chat Assistant, it might look like this in the app interface: ![How the added chatbot looks like](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F45878b2c-e800-4a94-bc8d-2eed9c2d4c54.jpg?alt=media\&token=fd4d1469-99e2-48f9-9337-90c5a58840ac) *** ## Step 3: Define How the Chat Assistant is Triggered Determine how users will activate or open the Chat Assistant. Common trigger methods include: * Clicking a specific button (e.g., "Make changes in photo using AI Chat Assistant"). * Performing a certain user action or event. * Automatically opening the Chat Assistant on visiting particular app pages or sections. **Example request:** > "The Chat Assistant should open only when the user clicks the button labeled 'Make changes in photo using AI Chat Assistant'." This approach keeps the interface clean and ensures the Chat Assistant appears contextually when users want to interact. *** ## Step 4: Example of Chat Assistant Interaction and Modification Request Once the Chat Assistant is active, users can type specific instructions to modify their profile images or get help. Here’s an example conversation and the resulting image update: User requests a change through the Chat Assistant interface: ![Change request example](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F8efe6550-6d5e-4d67-aaa8-a991c0be449c.jpg?alt=media\&token=416704f9-14d0-4e9a-9e23-7530e17c52cb) The Chat Assistant confirms the update and shows the modified image: ![Generated image changed according to request](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2Fea93c160-cc9b-4749-806d-71fd57b328c6.jpg?alt=media\&token=dfe3143e-b51a-4179-8bcc-77fec0ba2fcc) *** ## Summary: Sample Request Template for Your App Builder To make it easy, here’s a comprehensive message you can send to your app builder, combining all the key points: > "Please add a Chat Assistant to the app that can answer questions and make changes to the generated profile image based on user requests. Place the Chat Assistant icon in the bottom right corner of the screen, using the attached circular logo for its appearance. The Chat Assistant should be triggered only when the user clicks the 'Make changes in photo using AI Chat Assistant' button." *** By following these steps and including clear examples, you’ll ensure your app builder understands exactly how to implement a useful, branded, and user-friendly Chat Assistant that enhances your app’s functionality and user satisfaction. # Add your logo Source: https://docs.buildai.space/building-apps/how-to-change-the-logo-in-your-app Upload and display your brand logo across your app in a few simple steps. Personalizing your app’s branding by adding a logo is a key step to making a strong, professional impression. The most efficient and consistent way to upload your logo is through the **Brand section** in your app’s left panel. Uploading your logo here ensures it updates automatically across your app’s interface, browser tab favicon, app preview on your apps page, and more. > **Important:** There is currently *no option* to generate or create a logo directly within the AI chat builder. Logo creation must be done externally or through upcoming tools (see below). While it’s possible to upload a logo directly via the chat builder, this method bypasses the centralized branding workflow, which can lead to inconsistencies across your app. *** ## Why Use the Brand Section to Upload Your Logo? Managing your logo in the Brand section offers several critical benefits: * **Consistent Branding:** Your logo updates everywhere in your app automatically. * **Favicon Sync:** The browser tab icon (favicon) stays perfectly matched to your logo. * **Accurate Previews:** The app preview on your apps listing page always shows the latest version. * **Streamlined Workflow:** Centralized control keeps your branding process clean and professional. *** ## What if You Don’t Have a Logo Yet? If you don’t have a logo ready, the best solution is to create one using an external design tool or service. You can then upload your finished logo via the Brand section for seamless integration. > **Coming Soon!** We’re excited to introduce the **AILogoMaker** tool as part of BuildAI.Space. This upcoming feature will simplify logo creation with AI assistance, but for now, you’ll need to use external tools. *** ## How to Upload Your Logo via the Brand Section ### Step 1: Open the Brand Section From your app’s main dashboard, locate the **left side panel** and click the **palette icon** or the section labeled **“Brand”** to open the branding settings. ### Step 2: Upload Your Logo Scroll to the **Logo** area within the Brand section. Here, click the upload button or drag and drop your logo file. Supported formats are PNG and JPG. ![Brand section with logo upload area](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F03d27010-f0a0-471c-a969-64c40d38c61f.jpg?alt=media\&token=56a08d9b-0152-4c51-884a-65cb58e49ce8) ### Step 3: Save Your Changes After uploading your logo, be sure to click **Save Changes** at the bottom of the panel to apply your new branding throughout your app. *** ## What Happens After Uploading? Once saved, your new logo will update everywhere across your app, including: * The app’s main interface. * The browser tab favicon. * Your app’s preview on the apps listing page. * Any other locations where your app branding appears. This centralized update system saves you time and ensures your branding looks professional and consistent everywhere. *** ## Important Note: No Logo Generation in Chat Builder Currently, the AI chat builder does **not** include any feature to generate or create logos. All logo uploads must be done manually via the Brand section after designing your logo externally. Avoid trying to upload logos directly through the chat builder, as this bypasses the official branding workflow and can cause inconsistencies. *** ## Quick Tips for Uploading Your Logo * Use a **high-quality PNG or JPG** file for the best visual results. * Opt for **transparent backgrounds (PNG)** if your logo will appear over various backgrounds. * Always preview your app after uploading to confirm your logo displays correctly. * Avoid uploading logos through the chat builder; always use the Brand section for consistent updates. *** ## Summary * Access the **Brand section** from your app’s left panel. * Upload your logo in the **Logo** area. * Click **Save Changes** to apply your logo across your app. * This method guarantees consistent branding across the interface, favicon, app previews, and more. * If you don’t have a logo, create one externally and upload it via the Brand section. * Remember, there is *no* option to generate logos inside the AI chat builder. * Look forward to the upcoming **AILogoMaker** tool in BuildAI.Space for easy AI-assisted logo creation! *** Stay tuned for exciting updates, and happy branding! *** # Manage your data Source: https://docs.buildai.space/building-apps/how-to-manage-your-app-data Create, edit, and organize your app's data entities and records. BuildAI automatically generates the **entities** (data tables) your app needs to run smoothly. For example, a documentation hub might create entities such as *Category* (to organize topics) and *Document* (to store articles). Each entity functions like a smart database table, enabling your AI app to efficiently store and retrieve information. As you interact with the app builder, it can dynamically update these entities—adding new fields, altering field types, or creating entirely new entities to better fit your requirements. **Rest assured, your existing data remains completely safe.** The builder only modifies the structure (e.g., adding a "Priority" field to documents) without changing your actual content. > **Note:** Generating content directly through the chat builder is currently **not supported**. However, for direct image generation, you can use our AI-powered tool [**ImageCraft**](https://image-craft.buildaispace.app/) — create stunning product images from reference images or descriptions! After generating images with ImageCraft, simply upload them to your database or create your own admin page to manage and upload images seamlessly. *** ## 1. View Data & Navigate Entities To manage your app’s data, start by viewing and navigating your entities: * Click the **Database** tab on the left sidebar. * Select an entity, like *Category* or *Document*, to view its records. * You’ll see a table displaying all records for that entity, with most columns editable. * **Note:** The **Created At** and **User ID** columns are locked and cannot be modified. This interface provides a clear overview of your data and structure, making it easy to explore and understand. ![View Entities & Data](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/439527e9-5d82-4e26-a37e-64772f5e72f1.png?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=TgMfiF8JMt8cy5rNyUEOkxajBcrJufwL41Nw8%2BBd6HtW%2FDJcOjvm%2F6Otq1gyGSQVUc3iaQUAl6UiP5wnu8RyNsVso%2FmABaYO%2FQd7Ldxx6wIFFhJZTsqEX77uOE8gMcD6E338mehaFfCfmu4MSznL94Yz5AyEzI9UIshkHPsjyhLDci%2Brp8zo5DbdUj6tf87mLY%2FbwjOXrmUQCXbQ6ywXCxOywFpnUWyJlf21OWykzuyjT09nruIeauezHKP3m2VVODMPdphAz6eAZSyH%2BX0eg4lsgiJPprQnAhRAXTf84%2FRWJulwkh0kDDe5qJD33LO9D%2FN3JMYadJxZ1YJb5kT3wg%3D%3D) *** ## 2. Select & Edit a Record Editing data is simple and intuitive: * Click any editable cell within a row to modify its value. * For example, update the "Description" or "Icon" fields in a *Category* record instantly. * Changes save automatically as you type—no additional save button needed. This makes quick updates or corrections fast and hassle-free. ![Select & Edit Record](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/0e98f9a4-9c45-4241-8133-f4e9d96f6b57.png?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=B%2BjatO7cnFrHdrRVffnWr9zRv9rL8bTvKsAhP1Cx9HXYneqzimQofYDukQHe5fu8Wkvnwdz9MeCX321M%2BQH%2FGmU9BEWDlG6oXbBtmC5eeUiLtfow1K1UWn%2FaZHQHdOvmMfRjw1eFYdUnVkF1KBCMY6LpkVwwjZ3zrCvynw6H4Iw6RUSfKGuI3MDKzmtFFeexoCBAXuczINkOFmTTXR82%2BYZ1cc6GJ9aqxWKi0I9M9ge%2Fowv5q%2FLQUs5OzkwzH%2FkR0GhDErYK%2BhjlmgWaB4m3Il9UkoRVoxCMkrvvZSaTi5LhfTWs2%2F4gFUlwP%2BDDIJJ8rutRx9sSB3BtBNs1CzebmQ%3D%3D) *** ## 3. Switch Between Entities Your app may include multiple entities, each storing different types of data: * Click any other entity in the sidebar to switch views. * For instance, toggle from *Category* to *Document* to manage articles or guides. * Each entity has its own unique columns and data types tailored to your app’s needs. Switching entities efficiently organizes and separates your app’s data management. ![Switch Entities](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/cac941d7-cb9a-4f89-8c9a-fa84704a5dc1.png?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=PfJG%2FLs%2Fs4iixq29jNFbLKA%2BzTWffq01Roa2Svwpw%2BWk1%2BjqYLGYjzITppivFGFnsWFySjulAuL95iM9V7esGIzxqnLw4UmUAE2gVDfkOSIDccTavRsheTEnjtVR8FS1n%2Bu32ZsGRwkux6fM8ov7iCa3VxJzelp8PuuHiAG9GIF6kYktsRRWVzmafuuVcS%2BwEvTO%2B424y6vlqJIMW1BxSWXzLBqUphoPnt5X5Ctk%2BVGfn5a%2FGSGb67XKo740TtiEjYQPa7Hj7CtpDf22mQrkQJiLxDiR9ZFzQ3yuF%2BJn%2BYJr%2BGSn9BbxrDPtDc6zEK8%2BBZT6b4rTsODsmRX1UvgGUQ%3D%3D) *** ## 4. Add New Records Adding new data is straightforward: * Scroll to the bottom of the entity table and click **+ New**. * Fill in the fields for your new record. * Click the checkmark on the right to save your entry. * The **Created At** and **User ID** fields are filled automatically. This process helps you effortlessly expand your app’s content. ![Add New Record](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/f9a4917a-b01d-4dff-a594-dc2955da7d45.png?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=F8NJDDocVx9oY7HFiDpsUtM%2FDvDS4Po0LV4mqCGumSuCvB6SY%2FvIqLthg9pKrxAohIQimuM%2BqoyjmrSLc2pc%2BpIuNqYl3sZOadQk4kv9cZotwCVdgMVi2aZwbIXL2jYs17epidMuhDSozvA6RLKUvQUid8I6ZJYYksw69cRRaaaTnG6AFMqSLadAXwyCNtzwt9UXFDgMXJw2AE%2B8il3pE8aj46Nsi790JokbgX22JyqgXlJ56Hk3fJexN8%2BMwzW%2BrS7RorNnCIW7y1rvJ7mgvEVeUd3S1kWheSr%2Bgupz0MxULJC5zuZYQjihbLBlbMgiDWLCg2G1IJR9JGa1PqBwYA%3D%3D) ![Save New Record](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/c99cfa93-1d67-40e5-9599-71da842d57aa.png?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=WUrF%2BQb%2B3O20yUAMWUu7kpWt2L7lcevv0LWVIdieOprTGp0sH%2B%2BoLBepuxvHX6lPkpEZiweeqXaukxjLeDU6vWXktRbjKHzRwwLSBb5MgcU6lgByPwVrw3k4fz1atptaIUI5ZQSElyg7sWc97Vd%2FwFjanQrX%2BqYl%2FbivybM0UuTpuJNR9W8qR4Z6QMikJioUEbnL4uWDbtBzBDrkwaUZnjKeUmV7infAzqyc7t5oh7jZo82u1jBC%2ByFg3aTyZt1njp9DpY%2ByEMDReATCzt6g%2FXieJKEHYe7DphZptK0DKtwa8RRnDvJdXt9A4Dt1TJGGDLGinHqU%2BdT0FMUM0WvQhA%3D%3D) *** ## 5. Delete Records To remove data: * Click the trash bin icon on the right side of the record. * Confirm the deletion if prompted. * Deleted records are permanently removed. Use this feature carefully, as deletions cannot be undone. *** ## 6. Understand Default Columns: Created At & User ID Two system-managed columns help you track record history and ownership: * **Created At:** Timestamp showing when the record was created. This is locked and cannot be edited. * **User ID:** Identifier of the user who created the record. Also locked. These fields provide important context and are protected from accidental changes. *** ## How Entity Evolution Works As your app grows, the AI builder learns and adapts your data structure to meet your evolving needs. You can start with basic entities like *Category* and *Document* and later add: * A "Status" field in *Documents* (e.g., Draft, Published, Archived) * A "Priority" field in *Categories* (e.g., High, Medium, Low) * An entirely new *Author* entity to track content creators Simply instruct the builder with commands such as: * *"Add a priority field to categories"* * *"Track which team member wrote each document"* The builder updates your data structure instantly while keeping all existing data intact. *** ## Quick Tips * Use the **Export** and **Import** buttons at the top-right of the database view to back up or bulk upload data. * Locked columns (**Created At** and **User ID**) cannot be altered—they are managed by the system. * Inline editing saves changes immediately—no separate save button required. * Scroll horizontally to access additional columns if your entity contains many fields. * **Need new fields or entities?** Just ask the builder—it evolves your data structure without affecting your content. *** ## Using ImageCraft for Image Generation While content generation through the chat builder is not yet supported, you can create images easily using [**ImageCraft**](https://image-craft.buildaispace.app/), our AI-powered image generation tool. * Generate stunning product images from reference images or descriptions. * After creating images, upload them to your app’s database or manage them through your custom admin pages. * This workflow ensures your visual content integrates smoothly with your app data. Try ImageCraft today to enhance your app’s media assets effortlessly! *** That’s it! Your app’s data structure will continue to grow smarter and more organized as your needs change, all while keeping your information secure and easy to manage. Remember, for direct image creation, visit [**ImageCraft**](https://image-craft.buildaispace.app/) — create and upload your AI-generated images seamlessly. *** # Landing page Source: https://docs.buildai.space/building-apps/landing-page Generate a polished landing page for your app with one click using AI. Creating a stunning landing page is key to capturing visitors’ attention and turning them into loyal users. Thanks to AI-powered landing page builders, you can design a beautiful, fully integrated landing page for your app instantly — all with just one click! Plus, you can easily request edits anytime to keep your page fresh and perfectly aligned with your app’s growth. This guide will walk you through the straightforward steps of creating an engaging landing page that highlights your app’s features and story, using the latest example from the PawPals app. *** ## Step 1: Open the App Editor and Find the **Landing** Button In your app editor, look to the top right corner. You’ll find a button labeled **Landing** — this is your quick access to creating a landing page effortlessly. ![Landing Page Button in Editor](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/8ed30b7b-92de-49c0-8d1c-c9c72a8b18f7.jpg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=LUVXzyAhcfi7OIRVe6t09g1cP0RIs5Zrj9GsLhshkwei6AUMKCuBkcV28Pc3x1QDKnsZn5BAE575K6c8zN%2BjOE5%2Bh6U7YkbM%2FL9EqFgLXmIcf5mpEcjpDo9GKWMHtSQga0q0px3koUal7ha%2B5xrM1t4qAJaA8LfKtOBb7bdFkecx5IDdmfb6y5fCYb1AKIwsIbMvxqwuad1%2BgqyPgVRitOKja9vVitkvVeT8mZdx5nKahSRR99DJ8YZIChlATWorzkSrsRqwTD8R9F34uGheoZzcnHnNqDlKR6rYrZcv83MeILGL8mGMtmEWpTD1%2F%2BaIQPrMMYW2pJMjsL2EfRyzKA%3D%3D) *** ## Step 2: Click **Create Landing Page** After clicking the **Landing** button, a prompt will appear that explains how an effective landing page helps attract and convert visitors. Simply click **Create Landing Page** to let the AI generate a custom landing page tailored to your app. *** ## Step 3: Review Your AI-Generated Landing Page Within seconds, the AI builder will produce a polished landing page crafted specifically for your app. This page highlights your app’s key features and visually tells its unique story. Here’s the updated landing page example for PawPals, a platform dedicated to helping users find and adopt pets. Notice the clean, modern design with a warm, inviting color palette, clear calls to action, and a mobile device mockup showcasing the app interface: ![Updated PawPals Landing Page Example](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/048fee20-4c1d-49d0-8d65-acc31db7f8b0.jpg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=YW2Kg%2BNWO1twf3gvL26ZfHU33%2F%2B2C7TMbIn7BCoY1TbSLlNsnlR0o65j%2FIBOFzTv1c4BcSwz%2BprpXdeNhTiQjF%2FmNLVAnAGdVxbc6kdKXnHXd1OH52nPffHkKI2X3GfLsznvVxJMJ%2Fx%2BlcflHLfjroG1uAM5gq8fKbrY6H5MiG6wZ6wzxX49G5ASnZmbLPaoL2oucPAPIeVggye0BBszcb6Y%2Fb09AfBEL5af98j7yoEaLijXnKpBwBFl7iChF8T4Pz00HYf3HH4AjbNy9UbRBMRfDvdQNQzQXCECwAhGoFV1eU9TRN76sdvTabojriY0pvK%2BOQXMRM07Dpflxi5x1g%3D%3D) ### Key Features of This Landing Page Design: * **Warm, friendly headline:** “Find Your Perfect Furry Friend” uses bold typography with a splash of red to convey warmth and friendliness. * **Concise and engaging description:** Quickly explains how the platform connects users with adoptable pets. * **Clear CTAs:** Prominent **Get Started** and **List a Pet** buttons invite visitors to take action. * **Mobile app mockup:** Displays a pet profile on a smartphone, giving visitors a tangible preview of the user experience. * **Clean, balanced layout:** Ample white space and soft gradients create a welcoming, modern feel. *** ## Step 4: Connect and Publish Your Landing Page Your landing page is automatically linked to your app. Once you’re happy with the design, just click the **Publish** button in the top right corner to make it live instantly. *** ## Step 5: Request Edits Anytime with AI Assistance Want to tweak the text, update colors, or adjust the layout? No problem! Just tell the AI builder what changes you want, and it will update your landing page accordingly. This makes it easy to keep your page fresh and perfectly aligned with your app’s ongoing development. *** # Summary * Click the **Landing** button in your app editor to start. * Use the **Create Landing Page** button to generate an AI-powered landing page instantly. * Review the design, inspired by the warm, modern PawPals example. * Publish your landing page with a single click — fully connected to your app. * Request changes anytime by simply instructing the AI builder. Enjoy creating a stunning landing page that truly captures your app’s essence and delights your users — effortlessly! *** Happy building! # Login settings Source: https://docs.buildai.space/building-apps/login-settings Configure login methods and access controls for your app's users. You have full control over the login options available to your users in your app. This guide will walk you through setting up various authentication providers and show you how these options appear in the app login screen. *** ## Step 1: Choose Your Authentication Providers In your app settings section, you can enable or disable different login methods based on your preference and user needs. The available options include: * **Email Authentication**\ Choose between Magic Link (default) or Password login for email-based authentication. * **Google Login**\ Enable Google login with the option to use the default BuildAI Google Login or a Branded Google Login. * **Microsoft Login**\ Enable Microsoft account login for your users. You can toggle these options on or off and select the default method for each provider, giving you complete flexibility. Here’s an example of how this looks in the app settings: ![Authentication Providers Settings](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F0b647fd2-1bde-4476-84c9-ef7b65729de6.jpg?alt=media\&token=cbda0655-a396-495f-840e-55c8216e403e) *** ## Step 2: User Login Screen with Enabled Options Once you have configured your preferred login options, users will see a streamlined login screen that reflects your selections. For example, if Google and Microsoft login are enabled, along with email login via Magic Link, the login screen will display: * Buttons for **Login with Google** and **Login with Microsoft** * An email field for users to enter their email and continue with Magic Link or Password (based on your default choice) Here’s how the login screen might appear to your users: ![User Login Screen](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F6304f884-548d-422f-9bac-25cfad3955b9.jpg?alt=media\&token=44c8d9fc-f3c1-4a03-921e-1a186f639fdc) *** ## Summary * Go to your app settings to enable or disable login options. * Select the default method for Email and Google login. * Toggle Microsoft and Facebook login on or off as needed. * Your users will see only the login options you have enabled, making sign-in easy and secure. Enjoy customizing your app login experience! # Scheduling tasks Source: https://docs.buildai.space/building-apps/scheduling-tasks Set up automated tasks that run on a schedule inside your app. Scheduled Tasks allow you to automate your app's functions to run automatically at specific times or intervals. Think of it like setting an alarm clock for your app - you decide when something should happen, and the system takes care of running it for you. ## What Can You Do with Scheduled Tasks? * **Send daily reports** - Automatically generate and send reports every morning * **Clean up old data** - Remove outdated records weekly or monthly * **Sync information** - Keep your data up-to-date by running sync operations hourly * **Send reminders** - Trigger notification functions at specific times * **Run one-time operations** - Schedule a function to run once at a future date ## Requirements Scheduled Tasks are available on the **Moon plan** or higher. You'll also need to have custom integrations enabled for your app. ### Credits Usage Each scheduled task run costs **1 AI credit**. Additionally, any actions performed within your scheduled task that normally consume credits will still cost their regular amount. For example: * Sending an email uses credits as usual * Using AI features (like generating text or analyzing data) costs additional credits * Database operations and other standard actions follow their normal credit costs Keep this in mind when setting up frequently running tasks (like every few minutes) as credits can add up quickly. *** ## Getting Started There are two ways to create and manage scheduled tasks: 1. **AI Chat** - Simply tell the AI assistant what you want to schedule in plain language 2. **Scheduled Tasks Panel** - Use the visual interface to configure tasks manually Both methods give you the same result - choose whichever feels more comfortable for you. *** ## Method 1: Using AI Chat (Recommended for Beginners) The easiest way to create scheduled tasks is by chatting with the AI assistant. Just describe what you want to happen and when, and the AI will set it up for you. ### How to Use AI Chat for Scheduled Tasks 1. Open your app in the Builder 2. Open the **Chat** panel 3. Describe what you want to schedule in plain language !\[Screenshot: Chat panel location] `[SCREENSHOT PLACEHOLDER: Show the Builder interface with the Chat panel open]` ### Example Prompts Here are some examples of what you can say to the AI: | What You Want | What to Say | | -------------- | ----------------------------------------------------------------- | | Daily report | "Schedule the sendDailyReport function to run every day at 9 AM" | | Weekly cleanup | "Create a task that runs cleanupOldData every Monday at midnight" | | One-time task | "Run the sendWelcomeEmails function once on January 15th at 2 PM" | | Every hour | "Set up an hourly task to sync customer data" | | Specific days | "Schedule the backup function to run on weekdays at 6 PM" | !\[Screenshot: AI chat creating a scheduled task] `[SCREENSHOT PLACEHOLDER: Show a conversation where the user asks the AI to create a scheduled task and the AI confirms it was created]` ### What You Can Ask the AI to Do * **Create tasks** - "Schedule \[function] to run \[when]" * **List tasks** - "Show me all my scheduled tasks" * **Pause tasks** - "Pause the daily report task" * **Resume tasks** - "Resume the daily report task" * **Run immediately** - "Run the sync function now" * **Check status** - "What's the status of my scheduled tasks?" ### Tips for Talking to the AI * **Be specific about timing** - Say "every day at 9 AM" instead of just "daily" * **Use function names** - If you know the function name, include it * **Ask for help** - If you're unsure, ask "What functions can I schedule?" *** ## Method 2: Using the Scheduled Tasks Panel If you prefer a visual interface, you can use the Scheduled Tasks panel to create and manage tasks manually. ### Opening the Scheduled Tasks Panel 1. Open your app in the Builder 2. Look for the **Scheduled Tasks** option in the left sidebar or panels area 3. Click to open the Scheduled Tasks panel !\[Screenshot: Location of Scheduled Tasks panel in the Builder sidebar] `[SCREENSHOT PLACEHOLDER: Show the Builder interface with the Scheduled Tasks panel highlighted in the sidebar]` *** ## Creating a New Task (Panel Method) ### Step 1: Start Creating Click the **Add Task** button to open the task creation form. !\[Screenshot: Add Task button] `[SCREENSHOT PLACEHOLDER: Show the Scheduled Tasks panel with the "Add Task" button highlighted]` ### Step 2: Fill in Basic Information * **Task Name** - Give your task a clear, descriptive name (e.g., "Daily Sales Report", "Weekly Cleanup") * **Description** (optional) - Add notes about what this task does * **Function to Run** - Select which function should execute when the task runs !\[Screenshot: Task form with basic fields] `[SCREENSHOT PLACEHOLDER: Show the task creation form with name, description, and function dropdown fields]` ### Step 3: Choose Schedule Type You have two options: #### Recurring Tasks Tasks that run repeatedly on a schedule (hourly, daily, weekly, etc.) #### One-Time Tasks Tasks that run once at a specific date and time !\[Screenshot: Schedule type selection] `[SCREENSHOT PLACEHOLDER: Show the toggle or selection between "Recurring" and "One-Time" options]` *** ## Setting Up a Recurring Schedule When you choose a recurring task, you'll see a visual schedule builder. This makes it easy to set when your task should run without needing technical knowledge. ### Schedule Options | Option | Description | Example | | ------------------- | --------------------------------- | ---------------------------------- | | **Every X Minutes** | Runs at regular minute intervals | Every 15 minutes | | **Hourly** | Runs once every hour | At minute 0 of every hour | | **Daily** | Runs once per day | Every day at 9:00 AM | | **Weekly** | Runs on specific days of the week | Every Monday and Friday at 8:00 AM | | **Monthly** | Runs once per month | First day of every month | !\[Screenshot: Schedule builder interface] `[SCREENSHOT PLACEHOLDER: Show the visual cron schedule builder with different timing options]` ### Selecting Days of the Week (Weekly Schedule) When you choose a weekly schedule, you'll see buttons for each day of the week. Click on the days you want the task to run. !\[Screenshot: Day selection buttons] `[SCREENSHOT PLACEHOLDER: Show the day-of-week selection buttons (S, M, T, W, T, F, S) with some days selected]` ### Setting End Conditions For recurring tasks, you can choose when the task should stop running: * **Never** - The task runs indefinitely until you manually stop it * **After X runs** - The task automatically stops after running a specific number of times * **On a specific date** - The task stops on a date you choose !\[Screenshot: End conditions options] `[SCREENSHOT PLACEHOLDER: Show the end condition selector with the three options]` *** ## Setting Up a One-Time Task One-time tasks are simpler - just pick the date and time when you want the function to run. 1. Select **One-Time** as the schedule type 2. Use the date and time picker to choose when the task should run 3. The task will run once at that time and then automatically archive itself !\[Screenshot: One-time date/time picker] `[SCREENSHOT PLACEHOLDER: Show the datetime picker for one-time task scheduling]` > **Note:** The time is based on your current timezone, which is displayed next to the picker. *** ## Managing Your Tasks You can manage your tasks using either the AI chat or the panel. The AI chat is great for quick actions ("pause the daily report"), while the panel gives you a complete overview of all tasks. ### Viewing All Tasks **Via AI Chat:** Ask "Show me all my scheduled tasks" or "What tasks are scheduled?" **Via Panel:** The main panel shows all your scheduled tasks with important information at a glance: * Task name and description * Which function it runs * Current status (Active, Paused, or Archived) * Last execution result (Success, Error, or Never Run) !\[Screenshot: Task list view] `[SCREENSHOT PLACEHOLDER: Show the main task list with multiple tasks displaying their status badges]` ### Showing Archived Tasks By default, archived tasks are hidden from the list. To view them: 1. Look for the **"Show archived"** button in the panel header 2. Click it to reveal all archived tasks 3. Click **"Hide archived"** to hide them again This helps keep your task list clean while still allowing you to access old tasks when needed. !\[Screenshot: Show/Hide archived toggle] `[SCREENSHOT PLACEHOLDER: Show the "Show archived" button in the panel header and how the list changes when clicked]` ### Task Actions **Via AI Chat:** Tell the AI what you want to do, for example: * "Pause the weekly backup task" * "Update the task schedule as follows..." **Via Panel:** Click on a task to expand it and see available actions: | Action | What It Does | AI Chat Example | | ------------- | --------------------------------- | ------------------------------------------------- | | **Edit** | Change the task's settings | "Change the daily report to run at 10 AM instead" | | **Duplicate** | Create a copy of the task | "Duplicate the sync task" | | **Pause** | Temporarily stop a recurring task | "Pause the hourly sync" | | **Resume** | Restart a paused task | "Resume the hourly sync" | | **Run Now** | Immediately execute the task | "Run the backup task now" | | **Archive** | Permanently stop the task | "Archive the old report task" | | **Delete** | Remove the task entirely | "Delete the test task" | !\[Screenshot: Task actions menu] `[SCREENSHOT PLACEHOLDER: Show an expanded task with the action buttons visible]` *** ## Monitoring Task Execution ### Viewing Execution Logs Each task keeps a history of every time it ran. Expand a task to see its execution logs. The logs show: * **When it ran** - Date and time of execution * **Status** - Success, Error, or Timeout * **Duration** - How long it took to complete * **Error details** - If something went wrong, you'll see the error message !\[Screenshot: Execution logs] `[SCREENSHOT PLACEHOLDER: Show the expanded task view with execution logs displaying timestamps, status badges, and duration]` ### Understanding Status Indicators | Status | Meaning | | -------------- | ----------------------------------------------------------- | | 🟢 **Success** | The function completed without errors | | 🔴 **Error** | Something went wrong during execution | | 🟡 **Timeout** | The function took too long (over 3 minutes) and was stopped | | ⏳ **Running** | The function is currently executing | ### Troubleshooting Failed Tasks When a task fails, you can: 1. **View the error message** - Expand the log entry to see what went wrong 2. **Use "Resolve with AI"** - Click this button to get help understanding and fixing the error 3. **Run again** - Once you've fixed the issue, use "Run Now" to test it !\[Screenshot: Error details and Resolve with AI button] `[SCREENSHOT PLACEHOLDER: Show a failed task log with expanded error details and the "Resolve with AI" button]` *** ## Best Practices ### Naming Your Tasks Use clear, descriptive names that explain what the task does: * ✅ "Daily Customer Report Email" * ✅ "Weekly Database Cleanup" * ❌ "Task 1" * ❌ "My task" ### Choosing the Right Schedule * **Every few minutes** - Use for time-sensitive operations that need frequent updates * **Hourly** - Good for regular syncs that don't need to be instant * **Daily** - Perfect for reports, summaries, and cleanup operations * **Weekly/Monthly** - Use for less frequent maintenance tasks ### Monitoring New Tasks When you create a new task, it's a good idea to: 1. Use **Run Now** to test it immediately 2. Check the execution logs to make sure it succeeded 3. Review any error messages and fix issues before the scheduled time ### Setting End Conditions * Use **After X runs** when you know exactly how many times something needs to happen * Use **On a specific date** for temporary tasks (like a limited-time promotion) * Use **Never** for ongoing operations that should run indefinitely *** ## Frequently Asked Questions ### Should I use AI Chat or the Panel? **Use AI Chat when you want to:** * Quickly create a simple task with natural language * Perform quick actions like pausing or running a task * Get help figuring out what schedule you need **Use the Panel when you want to:** * See all your tasks at once * Configure advanced options like end conditions * Review execution logs and troubleshoot errors * Have more precise control over cron expressions Both methods work equally well - it's just a matter of personal preference! ### What timezone are schedules based on? Schedules use **UTC (Coordinated Universal Time)** for recurring tasks. The interface shows your local timezone for one-time tasks to make scheduling easier. ### How long can a task run? Tasks have a **3-minute timeout**. If your function takes longer than 3 minutes, it will be stopped and marked as "Timeout". ### Can I run a task manually? Yes! Use the **Run Now** button to execute any task immediately, regardless of its schedule. ### What happens if a task fails? The task will show an "Error" status, and you can view the error details in the logs. Failed tasks don't automatically retry - you'll need to fix the issue and either wait for the next scheduled run or use "Run Now". ### Can I edit a task that's currently running? It's best to wait until the current execution completes before making changes. ### What happens to one-time tasks after they run? One-time tasks are automatically archived after they execute successfully. ### How many tasks can I create? There's no set limit on the number of scheduled tasks you can create. *** ## Need Help? If you're having trouble with Scheduled Tasks: 1. Check that your app has custom integrations enabled 2. Verify you're on the Moon plan or higher 3. Review the execution logs for error messages 4. Use the "Resolve with AI" feature for help with specific errors !\[Screenshot: Help resources] `[SCREENSHOT PLACEHOLDER: Show where users can find additional help or support options]` # App install (mobile) Source: https://docs.buildai.space/building-apps/users-app-install-for-quick-access Let your users install your app on their mobile home screen for quick access. This guide provides clear, step-by-step instructions on how to enable the app install popup feature in your app’s settings and how users can install your app quickly on their mobile or desktop homepage for easy access. *** ## Step 1: Enable the Install Popup in Settings To prompt users with an install popup notification, you need to enable this feature within your app dashboard: * Go to the **Settings** section of your app dashboard. * Scroll down to the **App Installation** area. * Toggle the **Enable install popup** switch to **ON**. Enabling this activates a popup notification that appears when users open the app, encouraging them to install it. ![Enable install popup in settings](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/706dcae9-a8be-4b0c-a1ab-3134db850e21.jpg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=A898PZtySMF%2FkYf7643Xt8STZv90Szm%2B28jThz13gSzUuMqbC8Oy5VBKBQ%2B8xXQLC%2BtamA%2Fiyk3AM6fehDcoaq13oZDAy7Gou4oBKcK98Qe2kFiiN2AfoxPdSiqMx4Gro5FijqfWzHkCMBkqPzf3wHaBEcB74JbL%2FCRXgO5MlxFTxIfSQmeYf2YCinbobfQQtukPkWPKJdmHXYy8f4yKy9AiL4Z3CMkNXbmw3xsKyqXTfXbo2rn5JIhWWnT9b0o7%2FhEtvBrvNwK3BatHwWswRqfpsvvcNWwSB%2FUaZrNHGRdhwq7QnpIoJmD0rGeSn4nd3YKvGzudZtpln%2F9KgAAR8g%3D%3D) *** ## Step 2: User Sees the Install Popup Notification Once enabled, whenever users open the app on their mobile or desktop browser, they will see a popup notification at the bottom of the screen. * The popup invites users to install the app for faster, more convenient access. * It shows the app logo, name, and a clear **Install** button for easy interaction. Here is an example of how the popup looks on a mobile device: ![App install popup notification](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/0ca2ad79-eae5-408f-b3ab-2c69c71de9cd.jpg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=g4N%2BXHKl2N%2Bgw%2BKU%2FRX5Qfkop598HtV%2FE6RsFMYooHyI7D%2BijZMj8TZURt2kh5FkCyjuZAtVJReA5TSs%2BoJdfFWWXwVkqwRoxfhOw%2B2oA5ZSAFhE%2B%2FnGqHDwCMRvmp5sMr%2Fct8ZCfwl9uIAoynNg%2Bdojgc7LGKVsD1gtu3Qt4yRisBbkDhPZq%2F0Jt4h5SAn509T4uoOZI58p22CLBAW6qmnMHe221YJtnoK4wEFE4gefLofB8%2FRD0RRPMYDFadpH6ufHQgVcmKegEuu5cA2FyoHPEYHb4Iv90zJdWTyiPKtls80VsCbfnqU2W%2FPZHG6x%2Br9kd%2FhZydfS01DkknR8rg%3D%3D) *** ## Step 3: App Installed on User’s Homepage After clicking **Install** on the popup, the app is added to the user’s device homepage or desktop screen, allowing direct access without opening a browser. * The app icon features your app’s logo and name. * Users can launch the app instantly from their home screen. Below is the updated example image showing how the installed app icon appears on a mobile device’s homepage. Note that this image is smaller for better page balance and clarity: ![DecorVision AI app icon on mobile homepage](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/b3544138-d4bc-4ea3-bad4-25d70bfb474c.jpeg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=bndcpOvq7613cWmoNCWRU9D0pRUCYQ%2FMlNUhp%2BDZIRY7JsHt7hhggXRDAowY8W57EpDspQxEcD1HsT03KO75vCh34oZdwIWE%2FcgR9a6WLfarANf9PU3oRk1g4g0CEyJXDxUqJz96XhOLYHsuNnJY1dwBuX8QmMiaQ5ZBamt83CLOExTM9toYlEPCfFStYnX%2FuvFPRM13m5KT5OhrJrufF4sU7mEGjkwOHX9B4sRLO6iT5KkIdEAgR64iOifK%2FbcqzjqjfA2uxZ92enepkBG%2BqvOoNkeaYWfq%2FQ6IGdgsqMfN6NdToih8cnlcvnUjVk5GtdqAbRotzm5GuKi5fzPWWg%3D%3D) *** ## Summary * **Enable the install popup** in your app’s settings to activate the feature. * Users will **see a popup notification** prompting them to install the app when they open it. * Once installed, the app icon appears on their **device homepage** for quick and direct access. This feature significantly enhances user engagement by making your app instantly accessible from the home screen! *** If you have any questions or need further assistance, please feel free to reach out! # Version history Source: https://docs.buildai.space/building-apps/version-history Browse, compare, and restore previous versions of your app. The version history feature allows you to easily review and restore previous versions of your app while working in builder mode on desktop. This guide will walk you through the simple steps to access and use this feature effectively. *** ## Step-by-Step Guide ### 1. Locate and Click the Clock Icon When you are in builder mode on the desktop, look towards the top of the interface. You will see a **clock icon** representing the version history feature. Click on this clock icon to open the version history panel. ![Click the clock icon to open version history](https://storage.googleapis.com/buildai-4bad5.appspot.com/apps/MawKjabo6bFib5kF3Aac/users/test/1a9ae836-e481-43b6-abb3-50f50cc66b3e.jpg?GoogleAccessId=firebase-adminsdk-luuil%40buildai-4bad5.iam.gserviceaccount.com\&Expires=16553721600\&Signature=Z4e3VO0gfvEC1DfXWwtnQztxUETLD8V3GhaA88EcKJdMXoIApZaZI%2FV%2FFSUd2vDDPMXQ6nx0HrLhCVOyiJ11GWzcbMcJLXIvqHjOw6bbSywYTkyPT9f3nJfcahJ4cWYhordaIq5gkm7Zb4KDaKwh80BKuu0rvHS0yuj7OQUB%2FzJAhxhIPPuzUePnZkK1KofAROeBlPlAF12JQ7yU97hL2zIJzJqY70FTP5GmecsL2Ym0oCmruGc8vU1XUERXh3ZPibAYjywCbu9YmdaLPGeKV18kCD8dOUWZn7yoHQYmw9T2zrEfN%2BQCrb57BFHaTTcBlj0mHkaQg%2Bx8tvNzXgPfUw%3D%3D) *** ### 2. Review the Version Timeline After clicking the clock icon, a **right-side scroll panel** will appear displaying a timeline of your previous versions. Each version is marked with a timestamp and a brief description of the changes made. Use this timeline to **scroll through and find the version you want to restore**. *** ### 3. Select and Restore a Version Click on any version in the timeline that you want to restore. Once selected, the system will revert your app to that version. *** ### Important Note: * **Restoring an older version will remove all versions saved after it.** These subsequent versions will no longer be available. * However, **you can always restore older versions again if needed**, so don't worry about losing access to your past work permanently. *** By following these steps, you can confidently use the version history feature to manage your app's versions and ensure you can revert changes whenever necessary. Happy building! # What it can do Source: https://docs.buildai.space/digital-employees/capabilities Built-in superpowers every digital employee ships with — live web browsing, image and video generation, voice, a real workspace, and more. Every digital employee comes with a set of built-in superpowers — no setup, no connections, no skills required. These are things it can do out of the box from the very first message. On top of these, [Connectors](/digital-employees/connectors) plug it into your accounts and [Skills](/digital-employees/skills) teach it how to do specific jobs well. *** ## Browse the web — live Your employee can read the open web and **control a real browser** in the cloud — the same way you would. * **Search the web** for fresh information and pull back highlights with citations. * **Read any page** — articles, docs, product pages, forum threads — and summarise, extract, or compare. * **Live browsing** — navigate to a site, click buttons, fill in forms, scroll, and watch what happens. Your employee can sign into your accounts (with your permission), download files, and operate apps that don't have an API. * **Watch it work** — when your employee opens a live browser, you get a link to peek at the session in real time. Use this when you need anything the public web knows, or when a job involves clicking through a real interface. *** ## Generate and edit images Your employee can make images from a text prompt, edit images you give it, or combine multiple images into a new one. Results come back as a clean URL you can drop into emails, decks, or your app. Examples of what you can ask: * "Make a clean illustration for the top of my newsletter — bold flat colors, no text." * "Take this product photo and put it on a beach background." * "Combine this logo and this hero shot into one social card." Generated images can also be saved straight into [Google Drive](/digital-employees/connectors) or kept in the employee's workspace for follow-up edits. *** ## Generate videos Your employee can produce short videos from a text prompt or an image — useful for social posts, product demos, intros, and B-roll. Generation runs in the background and your employee tells you when it's ready. Like images, finished videos return as a URL you can hand off, share, or embed. *** ## Voice — speak and listen * **Text-to-speech** — turn a script into an expressive voiceover with a chosen voice (you can pick from named voices like "Rachel" or "Adam", or supply a custom voice). Supports expressive cues like whispers, laughs, and emphasis. * **Transcription** — drop in an audio file (mp3, wav, m4a, webm) and your employee transcribes it. Optionally returns timestamps for each segment or word — great for captions, meeting notes, or repurposing recordings. Use these for voiceovers, podcast workflows, meeting summaries, accessibility, or anything where audio meets text. *** ## A real workspace Every employee runs in its own private, isolated **sandbox** — a small Linux workspace where it can: * Create, read, edit, and organize files of any kind. * Run scripts and command-line tools to crunch data, generate reports, or process files. * Keep working notes, drafts, and intermediate output between conversations. * Search across its own files for facts it has saved. You can browse the workspace yourself any time under the **Files** tab. The sandbox is private to your employee — nothing leaks across employees or accounts. *** ## Talk to your apps and services Once you authorize a [Connector](/digital-employees/connectors), your employee can read and write through that service from inside chat — sending emails, booking meetings, posting to Slack, updating a CRM, pulling reports, and so on. Don't see a service you need? Your employee can talk to **any HTTP API** through a [Custom integration](/integrations/custom-integrations). *** ## Build and run your BuildAI apps Your employee can **build brand new BuildAI apps from chat** — a CRM, a content calendar, a daily dashboard — and then run them for you, populating records, updating statuses, and pulling live numbers without leaving chat. Existing apps you've already built work the same way: just point your employee at one and it takes over. Open any connected app from the **APPS** strip above the chat to see what your employee has been doing. See [Connected apps](/digital-employees/connected-apps) for the full walkthrough. *** ## Learn new skills Your employee can be **taught skills from a curated catalog** — drop-in playbooks for specific jobs like writing newsletters, vetting leads, building decks, or running QA. Open the **Skills** tab, pick a skill, and click **Teach** — your employee instantly knows the playbook, no extra prompting required. See [Skills](/digital-employees/skills) for the full list. *** ## Remember things and follow up * **Memory** — your employee remembers facts about you and your work between conversations. See the **Memory** tab. * **Scheduled tasks** — hand off recurring work and your employee runs it in the background, daily, weekly, or on any cadence. See the **Tasks** tab. *** ## Putting it together These capabilities compose. A single request can chain several of them without you having to say "now do this, now do that": > "Find me three recent articles about home espresso machines under \$500, pull the key specs into a sheet, generate a hero image for the roundup, and draft a Tuesday newsletter using my usual voice." That's a web search, multiple page reads, a Google Sheets write (Connector), image generation, and a drafted email — one prompt. Your employee figures out the steps and uses the right capability for each one. # Connected Apps Source: https://docs.buildai.space/digital-employees/connected-apps Hook your digital employee up to apps you've built in BuildAI - so it can read, update, and run them for you right from chat. Connected apps are the BuildAI apps your digital employee is allowed to work in. Instead of just talking about your todo list, content calendar, or CRM, your employee can actually open the app, add records, update statuses, and pull live data - then show you the app side-by-side with the conversation so you can see what changed. Think of it like handing a teammate the keys to a specific tool and saying "this one is yours to run." Every app you connect becomes a chip at the top of the chat. One click opens the app right next to your conversation. *** ## The Apps Strip When your employee has apps connected, you'll see a row labeled **APPS** at the top of the **Chat** panel, with a chip for each one. APPS strip showing connected apps as chips Click any chip to open that app in a side panel next to the chat. Click the chip again (or the X in the panel) to close it and go back to full-width chat. If you don't see the APPS row, your employee doesn't have any apps connected yet. Just ask in chat - for example, "manage my todo list" or "use my content calendar app" - and your employee will offer to connect an existing app or build a new one for you. *** ## Working Side-by-Side When you open an app from the strip, the chat shrinks to make room and the app loads on the right. You can keep chatting on the left while you watch the app update in real time. A Todos app open next to the chat panel This is useful for things like: * Watching your employee populate a **Todos** app while you're brainstorming priorities together. * Reviewing a **Content Calendar** while your employee schedules posts for you. * Spot-checking a **CRM** after asking your employee to log a new lead. Everything your employee does in the connected app shows up immediately, so you can correct course on the spot instead of waiting until the work is done. *** ## Working Together in the App A connected app isn't just a window into what your employee is doing - it's a shared workspace. You can step in and do things directly in the app, and your employee picks up on it without you having to repeat yourself in chat. You might: * **Add a record yourself.** Drop a new task into the Todos app and your employee will see it next time it acts. * **Edit or reorder things.** Drag a card to a new column, change a status, fix a typo. The employee treats the app as the source of truth. * **Leave notes for your employee.** Use a notes column or comment field to tell it what to do with a specific item, then ask in chat: *"Pick up the items I flagged."* * **Approve or reject before publishing.** For apps with a review step (drafts, queued posts, pending invoices), you stay in control of what actually goes out. This is the human-in-the-loop pattern: your employee does the heavy lifting, you make the calls that need a human judgment. Switching between chat and the app feels like working alongside a teammate, not handing work off to a black box. If you want your employee to take action on something you changed in the app, give it a nudge in chat - "I just added three tasks, please prioritize them." Your employee can read the app's data when it needs to, but it doesn't constantly watch every keystroke. For routine check-ins, set up a [scheduled task](/digital-employees/capabilities#remember-things-and-follow-up) like *"Every morning at 9, review new items in the Todos app and triage them."* - your employee will run on its own and only ping you when something needs your attention. *** ## Connecting and Disconnecting Apps You don't manage connected apps from a settings page - you talk to your employee about it. * To **connect an app**, ask your employee to start using it. For example: *"Manage my Todos app for me"* or *"Use Content Calendar to plan next week."* Your employee will confirm which app to connect. * To **disconnect an app**, ask your employee to stop using it. For example: *"You don't need to manage Pomodoro anymore."* Connected apps are scoped to a single digital employee. If you have two employees that both need to manage the same app, connect it to each one separately. *** ## Building and Refining Apps Your employee isn't limited to apps you've already built - it can spin up a new BuildAI app on the spot, and it can change the apps it's already connected to as your needs evolve. ### Build a new app from chat Just describe what you want. For example: > "Build me a simple Todo app with priority levels and due dates, and use it for our daily tasks." Your employee will scaffold the app, set up the data structure, and connect the new app to itself in one go. A new chip appears in the **APPS** strip and you can open it right away to see what it looks like. This is the fastest way to give your employee its own dedicated workspace. Instead of squeezing tasks into a generic tool, you get an app that's shaped exactly around the work you do together. ### Refine an existing connected app Once an app is connected, you can keep shaping it through chat. Ask for changes the way you'd ask a teammate: * *"Add a 'status' field to the Todos app with options Backlog, Doing, Done."* * *"Rename the 'Notes' column to 'Brief' across the content calendar."* * *"Make the dashboard show only this week's tasks instead of everything."* * *"Add a screen where I can see all blocked items in one place."* Your employee will update the app's schema, screens, or logic to match. The chip stays where it is - only what's behind it changes. ### When to build vs. refine A quick rule of thumb: * **Refine** when the app you have is mostly right and just needs a tweak (new field, renamed column, extra view). * **Build new** when the work itself is different (a separate workflow, a different audience, a clean slate). Two focused apps usually beat one app that does too much. If you're not sure, just describe what you're trying to do and let your employee suggest the right path. *** ## Frequently Asked Questions Any BuildAI app in your account can be connected. That includes apps you built yourself, apps you cloned from a template, and new apps your employee builds on your behalf. Yes - that's the point. Once an app is connected, your employee can read and write the records inside it (tasks, posts, leads, whatever the app stores) so it can actually do useful work. Apps you haven't connected stay private. The chip disappears from the strip automatically. Your employee will let you know if it tries to use an app that no longer exists. There's no hard cap, but in practice 2-4 apps per employee works best. Too many connections make it harder for your employee to pick the right tool for a given task. # Connectors Source: https://docs.buildai.space/digital-employees/connectors The full roster of services your digital employee can authorize against — email, calendar, files, CRM, marketing, support, and more. Digital employees authorize against external services using OAuth — you click **Connect**, authorize BuildAI in the popup, and your employee can read and write through that service from inside chat. We handle the OAuth flow, token refresh, and scope management for every connector below. Don't see what you need? Your employee can also call any HTTP API directly. See [Custom integrations](https://docs.buildai.space/digital-employees/connectors#custom-apis) for how to wire one up. ## Email & messaging | Service | What your digital employee can do | | --------------------- | ----------------------------------------------------------------------------------------------- | | **Gmail** | Google's email service. Read inbox, draft replies, summarise threads, send messages. | | **Outlook** | Microsoft's email and calendaring platform. Manage mail and events from the same workspace. | | **Slack** | Channel-based messaging. Post updates, reply in threads, search history, DM teammates. | | **Microsoft Teams** | Chat, video meetings, and file storage in Microsoft 365 — distributed-team collaboration. | | **WhatsApp Business** | Message customers through the WhatsApp Business API. *(Business accounts only — not personal.)* | ## Calendar & scheduling | Service | What your digital employee can do | | ------------------- | -------------------------------------------------------------------------------------------------- | | **Google Calendar** | Read your week, book meetings, block focus time, shift conflicts. | | **Calendly** | Automate meeting invitations, availability checks, and reminders without the email back-and-forth. | ## Files & docs | Service | What your digital employee can do | | ----------------- | ------------------------------------------------------------------------------------ | | **Google Drive** | Cloud storage — upload, share, search, and pull files into agent context. | | **Google Docs** | Real-time word processor with version history and Workspace integration. | | **Google Sheets** | Cloud spreadsheets — analyse, collaborate, and pull live numbers. | | **Google Slides** | Cloud presentations with templates and Workspace integration. | | **Dropbox** | File syncing, sharing, and version control across devices. | | **OneDrive** | Microsoft's cloud storage — sync, share, and collaborate across devices. | | **Excel** | Microsoft's spreadsheet app — formulas, charts, pivot tables, data analysis. | | **Notion** | Notes, docs, wikis, and tasks in one workspace — custom workflows for collaboration. | ## CRM & sales | Service | What your digital employee can do | | -------------- | --------------------------------------------------------------------------------------- | | **HubSpot** | Inbound marketing, sales, and customer service CRM with email automation and analytics. | | **Stripe** | Payment infrastructure and APIs — accept and manage payments globally. | | **Mailchimp** | Email marketing and automation — campaigns, segmentation, and performance analytics. | | **QuickBooks** | Cloud accounting — track income and expenses, manage finances, get business insights. | ## Tasks & projects | Service | What your digital employee can do | | ---------------- | ----------------------------------------------------------------------------------------- | | **Trello** | Web-based, kanban-style, list-making project management. | | **ClickUp** | Tasks, docs, goals, and chat unified — customizable workflows across projects. | | **monday.com** | Customizable work management — project planning, collaboration, and automation. | | **Airtable** | Spreadsheet-meets-database — organize projects, track tasks, build views and automations. | | **Google Tasks** | Simple to-do list integrated into Gmail and Google Calendar. | ## Marketing & social | Service | What your digital employee can do | | ------------- | --------------------------------------------------------------------------------------------------------------- | | **Facebook** | Social media and ads platform — post, manage Pages, and run promotions. *(Pages only — not personal accounts.)* | | **Instagram** | Photo, video, and story sharing. *(Business and Creator accounts only — not personal.)* | | **LinkedIn** | Professional networking — share content, connect, and discover business opportunities. | | **YouTube** | Video sharing, live streaming, and monetization for marketing, education, and entertainment. | | **Typeform** | Build interactive forms — collect data, accept payments, integrate with your stack. | | **Canva** | Drag-and-drop design — social graphics, presentations, marketing materials with templates. | ## Analytics & support | Service | What your digital employee can do | | -------------------- | ------------------------------------------------------------------------------------ | | **Google Analytics** | Track website traffic, user behaviour, and conversion data to optimize performance. | | **Zendesk** | Customer support — ticketing, live chat, and knowledge base for helpdesk operations. | *** ## Custom APIs If a service you need isn't listed above, your employee can still talk to it through a custom integration - simply describe the API in plain English and BuildAI will generate the calls and authentication scaffolding automatically. Your employee will use it just like any built-in connector. ### Example: Mailtrap Email Integration Mailtrap is an email delivery platform that helps send, test, and manage emails through APIs and SMTP. You can use it for sending transactional emails, notifications, marketing emails, and testing email workflows. You can connect Mailtrap to your digital employee or AI app using an API key. For example, you can simply tell your employee: > "Use Mailtrap to send welcome emails to new users" or: > "Send outreach emails using Mailtrap" BuildAI will understand the integration request and automatically guide you through the setup process. When needed, a secure popup will appear asking for your Mailtrap API key. Your credentials stay secure and are not exposed directly in prompts or workflows. Don't know where to find your API key? Your digital employee can guide you step-by-step through the process. Example instruction: > "Help me connect Mailtrap" For reference, this guide explains how to retrieve your Mailtrap API token: [Mailtrap API Token Guide](https://docs.mailtrap.io/email-api-smtp/setup/api-tokens?utm_source=chatgpt.com) The same integration approach works for both: * Digital Employees * AI Apps built with BuildAI See [Custom integrations](https://docs.buildai.space/integrations/custom-integrations) to wire one up. # Put your employee up for hire Source: https://docs.buildai.space/digital-employees/list-on-marketplace Train a great employee, pitch it for the public Ready Team, and collect a monthly paycheck for every active hire. If you've trained an employee that's genuinely good at a job — a newsletter writer with bite, a lead hunter that closes, a content engine that just keeps shipping — you can put it on the **BuildAI Ready Team**. When someone hires your employee, you start collecting a monthly paycheck for as long as they keep it. It's the same shelf where Emma, Ryan and Mira live. Yours just joins them. The marketplace is curated. We review every employee before listing to keep the shelf high‑signal. Don't worry — most rejections come with notes on what to tighten up. *** ## What makes a great Ready Team employee A great listing is **a teammate**, not a chatbot. The bar we use when reviewing: * **One job, owned well.** "Newsletter & retention manager" beats "general marketing assistant". * **Real tools wired up.** Connected to email, calendar, CRM, Slack — whatever the role demands. * **Tasks and routines.** It does work on its own (drafts on Tuesdays, follow‑ups at 24h), not only when chatted at. * **Voice and judgment.** It writes/talks the way the role would. Confident defaults, clear handoffs when it isn't sure. * **Useful out of the box.** A new hirer can plug in their accounts and see value in the first session. If those boxes are checked, you've got something worth listing. *** ## How to train an employee worth hiring 1. **Pick a sharp role.** Resist "AI that does marketing". Aim for "writes the Tuesday newsletter, scores leads, and re‑engages lapsed customers." 2. **Give it the right tools.** Open the **Connectors** and **Skills** tabs and wire up what the role needs (Gmail, Calendar, Sheets, your CRM, etc.). [Connectors guide →](/digital-employees/connectors) 3. **Teach it your standards.** Use the chat to drop examples — "this is the kind of subject line I want", "here's how we follow up after a no‑show". The employee remembers. 4. **Set up the recurring work.** Add scheduled tasks for the things that should happen on a cadence (weekly newsletter draft, daily lead recap, etc.). 5. **Use it for a week.** The single best filter for "ready to list" is *you actually relying on it for a week without babysitting*. *** ## Submit your employee for the marketplace When the employee is in shape: 1. Open your **Employees** dashboard. 2. Find the **Earn from your own employee** card on the Ready Team row. 3. Click **Pitch your employee**. 4. In the dialog: * **Pick** the employee from your account. * **Suggest a price** — what you think a customer would pay per month. We may adjust before listing; treat it as a starting point. * **List its skills** — one per line. Be concrete: "Drafts and schedules the Tuesday newsletter" beats "does email marketing." 5. Hit **Submit for review**. That's it. You'll get an email at your account address once we've reviewed it. The skill bullets you write are the ones that may show on your listing card — write them like a sharp job description, not like a feature list. *** ## What happens after you submit * **We review within a few business days.** The review checks role clarity, tool setup, the quality of its work, and pricing fit. * **If accepted**, we polish the listing copy, finalize a price, and put your employee live on the Ready Team. From there you collect a monthly paycheck for every active hire. * **If we have notes**, we'll reply with what to tighten — usually a sharper role, better defaults, or a missing routine. Iterate and resubmit any time. *** ## Pricing & paycheck * The price you suggest is a starting point. We may adjust based on what the role tends to clear in the market. * Paycheck details and cadence are sent with the acceptance email. *** ## FAQ Yes. You can pitch as many as you want — each goes through review on its own. A clean clone. Your original keeps running in your account; each hirer gets their own copy with its own memory, tools, and history. Yes — you keep training your master copy and we periodically refresh the listed version. We strip account‑specific memory and connections before listing. Only the role, instructions, skills, and configuration carry over. *** Questions? Email [hello@buildai.space](mailto:hello@buildai.space) — we read everything. # Overview Source: https://docs.buildai.space/digital-employees/overview Personal AI teammates that work for you - getting things done on your behalf, around the clock. Digital employees are personal AI teammates that work for you. You describe the kind of helper you want, and BuildAI hires you a digital employee with its own personality, memory, and tools - then it gets to work on your behalf, 24/7. You don't have to drive every step. Tell your digital employee what you need and it takes it from there - writing, researching, reaching into your Gmail or Calendar, and handling the follow-through. Think of it as hiring a smart assistant who gets better at helping you the longer you work together. **And the best part? They even talk in your language.** Digital employees are an early feature. You can talk to your employee in BuildAI web chat, or connect it to WhatsApp and Telegram - see [Channels](#channels) below. *** ## How to Hire a Digital Employee 1. Open BuildAI and go to your **Employees** dashboard. 2. Describe the kind of employee you want in the prompt box. For example: > "A marketing assistant that writes blog posts and manages my social media." 3. Click **Hire Employee**. BuildAI will give your new employee a name, a personality, and a private workspace, then open it in the builder. You can also **hire from our ready team** - a curated set of skilled digital employees (Emma the newsletter pro, Ryan the leads hunter, and more) pre-trained for common roles. Click any of their cards on the Employees page to bring them into your account. Employees *** ## Meet Your Employee Once your employee is hired, you land in the **builder**. This is where you chat with your employee and shape how it thinks and works. The layout has two parts: * **Sidebar (left)** - navigation between Chat, Connectors, Memory, Skills, Files, Tasks, and Settings * **Chat panel (center)** - where you talk to your employee Your employee greets you with its name, a short intro, and a suggestion for what to do next based on the prompt you used to hire it. *** ## Chatting with Your Employee The **Chat** tab is the main way you work with your employee. Just type what you want - it's designed to respond like a capable coworker, not a form to fill out. You can ask it to: * Write, summarize, or edit content * Do research on the web and give you the highlights * Save facts and preferences for later ("remember that my business is called Acme") * Connect to your Gmail or Google Calendar and act on your behalf * Build and run small background tasks for you You don't need to learn commands or trigger words. The employee figures out what tools it needs and uses them behind the scenes. Chatting with a digital employee *** ## Memory The **Memory** tab is where you shape who your employee is and what it knows about you. It includes: * **Profile** - your employee's name, emoji, avatar, creature type, and vibe * **Soul** - your employee's personality, boundaries, and core values * **User** - what the employee has learned about you (your name, timezone, preferences, notes) * **Memory** - long-term notes the employee has saved from your conversations * **Knowledge files** - any documents or notes you want the employee to be able to reference You can edit any of these directly, and your employee will also update them on its own as it learns more about you. Memory tab with profile, soul, user, and memory *** ## Connectors The **Connectors** tab is where you plug your employee into the services you already use - Gmail, Slack, Notion, HubSpot, Stripe, and 25+ others. Once connected, your employee can read, write, and act in those tools from inside a normal conversation - sending emails, booking meetings, posting updates, pulling reports, and more. To connect a service, click **Connect** on the connector card and authorize BuildAI in the popup window. Connectors panel See the full list of supported services in [Connectors](/digital-employees/connectors). Need something not on the list? Your employee can also call any HTTP API via a [Custom integration](/integrations/custom-integrations). *** ## Skills The **Skills** tab is a built-in catalog of curated capability packs you can teach your employee — playbooks for specific kinds of work, like writing weekly newsletters, vetting inbound leads, or running research deep-dives. Browse the catalog, open a skill, and click **Teach \[your employee]**: the playbook drops into your employee's workspace and syncs to its sandbox on the next run. See the [Skills guide](/digital-employees/skills) for how to teach, unlearn, and combine skills. *** ## Files The **Files** tab gives you a peek inside your employee's private workspace. Every employee gets an isolated sandbox - a clean, safe environment where it can create files, run scripts, and store working documents. You can browse folders, open files, and edit them directly. This is helpful when your employee is working on something longer like a report, a script, or a multi-step project. *** ## Tasks The **Tasks** tab is for automations that run on a schedule. You can hand off recurring work and your employee will run it in the background. For example: > "Every weekday morning at 8am, check my calendar and email me a summary." Your employee sets up the schedule and runs the task automatically. Tasks can run once at a future time, or on a recurring schedule (hourly, daily, weekly, and so on). Tasks panel for scheduled automations *** ## Settings The **Settings** tab is where you manage secrets - things like API keys or passwords your employee might need to talk to other services. Secrets are encrypted and never shown in chat. If your employee needs a key it doesn't have, it will ask you to add it here. Settings panel for secrets and API keys *** ## Channels The **Channels** section at the bottom of the sidebar is where you connect your employee to the messaging apps you already use. Messages from every channel land in the same conversation as the web chat, so you can pick up right where you left off. * **BuildAI Chat** - the web chat you're already using, always on * **WhatsApp** - click **Connect**, scan the QR code with your phone, and send the prefilled message. Your employee gets its own number you can text like a coworker. * **Telegram** - click **Connect** and scan the QR code. Your employee gets its own dedicated Telegram bot - just tap **Create** when Telegram asks, and don't change the suggested name. To disconnect a channel, open the Channels panel and click **Disconnect** next to it. *** ## Frequently Asked Questions An app is something you build with pages, buttons, and a user interface - whether it's for your customers, your team, or just you. A digital employee doesn't have a UI you design; you shape it by chatting with it, and it works by holding conversations with you. Yes. Your employee uses the **User** and **Memory** files in the **Memory** tab to hold on to facts about you, your preferences, and past work. You can view or edit these any time. Yes. Every employee gets its own isolated sandbox that only you can see. Nothing your employee does is shared with other users or other employees. Yes. Open the **Memory** tab and edit the **Profile** or **Soul** files. Your changes take effect right away. Only through services you've connected under **Integrations** and given permission for. Your employee will usually confirm with you before doing anything that goes outside the chat - like sending an email or posting to Slack. Go back to your **Employees** dashboard, open the employee's menu, and choose **Delete**. This removes the employee, its workspace, and its memory. # Skills Source: https://docs.buildai.space/digital-employees/skills Drop-in capability packs from a curated catalog — teach one to your digital employee and it instantly knows how to do the job. Connectors plug your employee into your accounts. **Skills** teach it *how to use them well.* A skill is a curated pack of instructions and reference files for a specific kind of work — writing weekly newsletters, vetting inbound leads, building decks, running QA on a piece of writing. You teach one to your employee, and it instantly has the playbook for that job. Think of it like onboarding a new hire with a binder for the role, instead of explaining the whole thing from scratch in chat. Skills are a complement to [Connectors](/digital-employees/connectors), not a replacement. Connectors grant access; skills shape how the work gets done. *** ## Where to find Skills Open your digital employee, then in the sidebar click **Skills**. You'll land in the catalog browser. You can: * **Search** by name, tag, or keyword (e.g. "newsletter", "research", "lead scoring") * **Filter by category** — writing, research, sales, ops, and more * **Open any skill** to read what it does and preview the files it ships with *** ## Teaching a skill to your employee 1. Click a skill card to open its details. 2. Review the description, category, and the files included. 3. Click **Teach \[your employee]** at the top of the panel. That's it. The skill's files drop into your employee's private workspace and sync to its sandbox on the next run. Your employee picks up the new playbook automatically — no restart, no extra prompt. Skills your employee already knows are marked in the catalog, so you can see what's already on board at a glance. *** ## Having your employee forget a skill Open a skill your employee already knows and click **Have \[your employee] forget this**. Confirm, and the files are removed from its workspace on the next conversation. The catalog entry stays available — you can teach it again any time. *** ## What's inside a skill Each skill is a small bundle: * **`SKILL.md`** — the main instruction file. This is the playbook your employee follows: how to approach the work, what good output looks like, common pitfalls to avoid. * **Supporting files** — examples, templates, checklists, reference data — whatever the role needs to do the job well. You can preview every file before teaching it, so there are no surprises. *** ## Skills vs. the rest of the sidebar Your employee's sidebar has a few different tabs, and it helps to know which one to reach for: | Tab | What it's for | | -------------------------------- | ------------------------------------------------------------------------------------- | | **Memory → Soul** | Who your employee *is* — personality, voice, values. Stays the same across every job. | | **Memory → User / Memory files** | What it has learned about *you* — your business, preferences, past decisions. | | **Connectors** | Which external services it can read and write — Gmail, Slack, HubSpot, etc. | | **Skills** | *How* to do a specific kind of work well — the playbook for a job. | A digital employee with the right **Soul + Connectors + Skills** is the equivalent of a teammate who knows you, has access to your stack, and has done this kind of work before. *** ## Frequently Asked Questions Yes. Skills compose — teach as many as the role needs. Your employee will pick the right playbook based on what you're asking it to do. No. The **Soul** (personality, voice) and **User / Memory** files are separate from skills. Skills only add a job-specific playbook — they don't touch who your employee is. Some do, some don't. A "weekly newsletter" skill expects Gmail or your email tool to be connected; a "research" skill works standalone. The skill's description tells you what it needs. Yes. Skill files live in your employee's workspace and you can edit them under **Files**. Changes take effect on the next run. The catalog is curated by the BuildAI team. New skills get added regularly — keep an eye on the browser for fresh playbooks. # FAQ Source: https://docs.buildai.space/getting-started/faq Quick answers to common questions about BuildAI, pricing, and app building. Not at all. Simply describe what you want, and we'll build it for you. No coding required. You can start building immediately after signing up. Most entrepreneurs launch their apps within days, not months. Your app is created instantly based on your requirements. After a few iterations to refine it, you can typically launch within hours, not months like traditional development. Yes. You can add your own data to make it accessible to your users in a structured way. Personalized recommendations, automated analysis, intelligent assistants, content generation, and more — all based on your expertise. Your app uses AI to provide personalized experiences to each user based on their needs, leveraging your expertise. Builder messages let you tell our AI what to create or modify on your app. Each message counts as one builder message. Yes! You can customize colors, logos, and layouts to match your brand. Premium plans also allow you to use your own domain with no BuildAI branding. # Build your first app Source: https://docs.buildai.space/getting-started/how-to-build-your-first-app Describe your idea in plain language and get a working app in minutes. Creating your own app has never been easier. Just describe what you want, and BuildAI handles the rest — no coding needed. Here's how it works. *** ## 1. Describe Your App Idea Start by telling us what you want your app to do — in your own words, any language you prefer. Just type as if you're chatting with a friend. Not sure how to phrase it? Use our **Prompt Builder** — it walks you through simple questions about your audience, features, branding, and more to shape your app. ![Prompt Builder helps you create detailed app requests](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2Fcd8f3823-3d04-4473-914e-0b9f3b99b7ff.jpg?alt=media\&token=20401ffd-cf79-4c2e-8d04-482839b35072) **Example:** *"Build a client portal where my customers can access their projects, make payments, and communicate with my team."* Once you're happy with your request, click **Build My App** and we'll get started! *** ## 2. We Build It For You After submitting your idea, BuildAI goes to work — writing the code, setting up databases, login systems, and everything else behind the scenes. It usually takes just a few minutes. *** ## 3. Preview and Refine Not perfect yet? No problem. You can keep chatting with BuildAI to make changes — just describe what you want differently. Break requests into smaller steps for the best results, and if something isn't right, revert and try again. **Example tweak:** *"Add AI-generated plans that adapt to my progress."* *** ## 4. Publish and Share Once you're happy with your app: * Click **Publish** to make it live. * Customize your app's URL to match your brand. * Share it with your customers, audience, or team. ![Publish button in the BuildAI interface](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FT7bmOuNUliXu3aCLQl0sE0aRWZo2%2F1aff9783-eb88-46a8-b5b4-5dca506cc84f.jpg?alt=media\&token=d6e018a7-2a9d-4e07-8b74-4eba9e183cca) Learn more about publishing here: [How to Publish Your App](/getting-started/how-to-publish-your-app) *** ## 5. Keep Improving Your app isn't set in stone. You can always: * Make updates in your private version. * Preview changes without affecting the live app. * Publish new versions when you're ready. Your app grows as your business does. *** ## Quick Tips for a Smooth Build * Keep your requests clear and detailed for the best results. * Use the Prompt Builder to organize your thoughts. * Preview your app often, switching between device views on desktop and toggling user modes to catch any issues early. * Don’t hesitate to revert changes and try different ideas. *** You’re all set to build amazing apps effortlessly — just like talking to a friend! Have fun creating and sharing your vision with the world. 🎉 # Publish your app Source: https://docs.buildai.space/getting-started/how-to-publish-your-app Make your app live and share it with the world in a few clicks. Give your app its very own unique and memorable link, ready to share with friends, clients, or your audience. Once your app is ready, just follow these easy steps to make it live and accessible online! *** ## Step 1: Click the Publish Button From your app dashboard, find the **Publish** button at the top right corner. This is your gateway to making your app available on the web. Click the **Publish** button to open the publishing options. Here, you’ll see your app’s default link, which typically looks like this: "your-app-name.buildaispace.app" ![Publish button](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FNssY3KdH32OfNVQr3FyO3IRBuAy1%2F8aaa39f9-cd8f-45ea-994e-3ecf1f4e2d70.jpg?alt=media\&token=e92c9006-7a24-4896-8a87-5e6ce672800a) ![Publish options](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FNssY3KdH32OfNVQr3FyO3IRBuAy1%2F76268471-8e88-432c-9b08-e9b65e2cb0f4.jpg?alt=media\&token=61675643-eb75-437a-9b76-6b7b5a8c7890) *** ## Step 2: Customize Your App Link You can personalize your app’s link by clicking the **Custom Domain** button in the publishing options. This opens two flexible options: ![Edit app link](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FNssY3KdH32OfNVQr3FyO3IRBuAy1%2F211ab866-29af-4679-b263-1bf4769f0889.jpg?alt=media\&token=938b3501-70f2-4178-95ef-64e8e56c822b) 1. **Change your app’s subdomain** under the buildaispace.app domain. For example, switch from: "mynewapp.buildaispace.app" to "video-generator.buildaispace.app" 2. **Set up your own custom domain** to have a fully branded URL that uses your own domain name (this feature is available on certain plans). Want to learn how to set up your custom domain step-by-step? Check out our detailed guide here:\ [How to Setup a Custom Domain](/launch/how-to-setup-custom-domain) This flexibility helps you create a link that’s easy to remember, on-brand, and professional. *** ## Step 3: Share Your App Link! Once your app is published and your link is set, it’s ready to share with the world! Post it on social media, include it in emails, add it to your website, or send it directly to friends and clients. *** ## Step 4: Keep Your App Updated When you make changes to your app after publishing, you’ll see a small red dot on the **Publish** button, indicating that there are unpublished updates. To publish the latest version: * Click the **Publish** button again. * You’ll see an “Updates available” message with an **Update** button. * Click **Update** to push your changes live. ![Unpublished changes - new version publish](https://firebasestorage.googleapis.com/v0/b/buildai-4bad5.appspot.com/o/apps%2FMawKjabo6bFib5kF3Aac%2Fusers%2FNssY3KdH32OfNVQr3FyO3IRBuAy1%2F9a148fed-c170-478d-87ff-c6d44b2d5cbf.jpg?alt=media\&token=fcf4a706-a40d-4ba8-a201-d4f9c09ca906) *** ## Step 5: Hide Your App When Needed If you want to temporarily take your app offline, open the publish options and click **Unpublish app**. This action removes your app’s live link and hides it until you publish it again. *** ## Summary * **Click the Publish button** in your dashboard to open publishing options. * **Customize your app link** by clicking the **Custom Domain** button. Choose to change your subdomain under buildai.space or set up your own custom domain. * For a full walkthrough on setting up a custom domain, visit: [How to Setup a Custom Domain](/launch/how-to-setup-custom-domain) * **Share your app’s link** easily once published. * **Update your app** anytime by clicking the red dot on the Publish button and selecting **Update**. * **Unpublish your app** to temporarily take it offline. Now you’re all set to launch your app with a link that fits your style—quickly, easily, and professionally! *** ``` ``` # Welcome to BuildAI Source: https://docs.buildai.space/index Guides, tutorials, and references to help you build, launch, and grow with BuildAI. You've got the idea - now let's make it real. BuildAI helps you create and launch your own AI-powered apps, no coding required. Whether it's your first app or your tenth, these docs will walk you through every step. Browse around, find what you need, and when you're ready - head back to [BuildAI](https://www.buildai.space) and start building. ## Get Started Learn the basics and get up and running quickly Create powerful AI-powered apps and tools Publish your apps Monetize your apps and tools Practical examples and inspiration for your next project Manage your account and subscription Connect with external services and APIs Submit a detailed support ticket and get personalized assistance # Built-in integrations Source: https://docs.buildai.space/integrations/built-in-integrations Use ready-made integrations for file uploads, email, AI images, data extraction, and more. BuildAI empowers you to build smarter, more capable apps quickly by offering a rich set of **built-in integrations** that require no extra setup or coding. These integrations add essential features right out of the box, allowing your app to handle tasks like file management, data extraction, AI-powered image generation, email automation, and advanced content processing. Beyond these, BuildAI also supports **custom integrations**, providing you the flexibility to connect your app with virtually any external service or API tailored to your specific needs. Learn more about custom integrations in the [BuildAI Custom Integrations documentation](/integrations/custom-integrations). *** ## What Are Built-in Integrations? Built-in integrations are ready-to-use, pre-configured tools embedded directly in the BuildAI platform. They help your app: * Manage files and media effortlessly * Extract structured data from documents and images * Generate and edit images using advanced AI * Automate email communications triggered by user actions * Leverage AI for content generation, summarization, and analysis Each integration uses your **AI credits** based on your subscription plan. Be sure to review your [pricing plan](#) to understand usage limits. *** ## Overview of Built-in Integrations | Integration | Description | Example Use Cases | | ------------ | -------------------------------------------------------------- | ---------------------------------------------- | | File Uploads | Securely upload and manage images, documents, and videos | Upload photos, project briefs, artwork | | Extract Data | Convert PDFs, receipts, forms, and images into structured data | Parse receipts, extract contacts | | AI Images | Generate, edit, and enhance images with AI tools | Create logos, design posts | | Send Emails | Automate email sending based on app events | Confirmations, welcomes, milestone alerts | | Smart AI | Generate, summarize, and analyze content intelligently | Personalized plans, recommendations, summaries | *** ## 1. File Uploads Allow your users to upload images, documents, and videos securely. These files are stored and organized within your app’s environment, ready for use. ### Use Cases * Upload before/after photos in a fitness app * Submit project briefs in consulting apps * Share recipe photos in cooking apps * Upload artwork in portfolio apps * Submit legal documents in service apps ### Sample Prompts ``` Let users upload before/after photos in my fitness app Allow clients to submit project briefs in my consulting app Enable recipe photo uploads in my cooking app Let users upload their artwork for my portfolio app Allow document uploads for my legal services app ``` *** ## 2. Extract Data Automatically transform unstructured documents like PDFs, receipts, and business cards into clean, actionable data. ### Use Cases * Extract nutrition info from food photos * Parse receipts for expense tracking * Extract contact info from business cards * Pull workout statistics from screenshots * Extract property details from real estate photos ### Sample Prompts ``` Extract nutrition info from food photos for my nutrition app Parse expense receipts for my budgeting app Extract contact details from business cards in my CRM app Pull workout data from fitness tracking screenshots Extract property details from real estate photos ``` *** ## 3. AI Images Create and modify images effortlessly using advanced AI. Generate logos, enhance photos, and design engaging graphics. ### Use Cases * Generate workout illustrations * Remove backgrounds from product photos * Enhance before/after photos * Create branded thumbnails for courses * Design custom recipe photos ### Sample Prompts ``` Generate custom workout illustrations for my fitness app Remove backgrounds from product photos for my e-commerce app Enhance before/after photos for my fitness app users Generate branded thumbnails in my course app Create branded social media posts for my marketing app Create custom recipe photos for my cooking app ``` *** ## 4. Send Emails Automate email notifications triggered by user actions. Perfect for confirmations, welcomes, alerts, and personalized communication. ### Use Cases * Email users after completing workouts * Send welcome emails to new subscribers * Confirm appointments booked by users * Congratulate users on milestones * Deliver customized meal plans ### Sample Prompts ``` Email users when they complete a workout in my fitness app Send welcome emails to new subscribers in my course app Email appointment confirmations when users book in my scheduling app Send congratulations emails when users reach milestones in my coaching app Email custom meal plans when users update their preferences ``` *** ## 5. Smart AI Use AI to generate content, summarize long texts, organize information, and analyze data—ideal for writing assistance, research, and simplifying complex topics. > **Note:** Smart AI calls consume AI credits per your subscription plan. ### Use Cases * Generate personalized workout plans * Create meal plans from user goals * Help users write professional emails * Build custom learning modules * Generate product recommendations ### Sample Prompts ``` Create personalized workout plans for my fitness app Generate meal plans based on user preferences and goals Help users write professional emails in my business app Create custom learning modules for my course app Generate product recommendations for my e-commerce app ``` *** ## 6. Custom Integrations If your app requires functionality beyond the built-in options, BuildAI’s **custom integrations** enable you to connect with external APIs and services tailored specifically to your needs. Whether you want to integrate a third-party CRM, analytics tool, or any other service, custom integrations provide the flexibility to extend your app’s capabilities seamlessly. Explore the full details and step-by-step guidance on creating and managing custom integrations in the [BuildAI Custom Integrations documentation](/integrations/custom-integrations). *** # Connect to any API Source: https://docs.buildai.space/integrations/custom-integrations Connect your app to any external API or third-party service. Connect your app to any external API or third-party service using custom integrations.