# Tips and Tricks

Clear, structured prompts and thoughtful testing are key to getting the most out of **Thunkable AI**. When you clearly explain what you want, provide organized inputs, and test changes step by step, the AI can better understand your intent and deliver more accurate results.

This guide is here to support you along the way. It walks you through how to write effective, easy-to-understand prompts, use AI features intentionally, and steer clear of common mistakes that can slow you down. Whether you’re just getting started or refining an existing project, these best practices will help you work more efficiently, reduce frustration, and build higher-quality apps with confidence.

{% hint style="success" %}
Take your time with prompts. Re-check everything. Break work into small tasks. The more precise your inputs, the better your outputs.
{% endhint %}

### 1. Explain your goal in one paragraph

Write one clear paragraph with a few sentences that explain exactly what you want the AI to do.

**Send a specific and clear paragraph:**

> ✅ Please make an app for math calculations with 3 screens to help students deal with math problems. I need a page to set the problems, one page with math exercises history, and one for the settings.

**Avoid multiple-paragraph prompts. For example**:

> ❌ Create a Math Learning mobile app that uses Firebase email and password authentication to manage user access. The app should provide a clean and simple user experience focused on learning and practicing mathematics.
>
> The app should include a Login Screen where users can enter their email and password and sign in using a Sign In button. Firebase Authentication (email/password) should be used to validate the user’s credentials and securely log them into the app.
>
> There should also be a Signup Screen that allows new users to create an account. This screen should include fields for email, password, and confirm password, along with a Sign Up button. Upon successful registration, the user should be authenticated using Firebase and redirected into the app.
>
> After a successful login or signup, the user should be taken to the Home Screen, which serves as the main math dashboard. This screen can display math lessons, quizzes, or practice activities. The Home Screen must include a Logout button that allows the user to sign out of the app.

### 2. Specific prompts

Clearly describe what should change, where it should happen, and what the expected result is.

**Good examples:**\
✅ *Add a cat image on the first screen.*\
✅ *On the first screen, calculate the total number of posts from the list.*

**Avoid generic prompts:**\
❌ *Update the style to be more modern and add some images*\
❌ *Can we improve it?*\
❌ *Change the user interface*

### 3. Use natural language

Write prompts the same way you would explain a task to another person.

**Good example:**\
✅ *Please make a math learning app with a home screen, a favorites screen, and a settings screen.*

**Avoid technical or HTML-style prompts:**\
❌### \[PROJECT: SOVEREIGN\_V10\_SPECTER\_CORE\_ALPHA] ### \[CLEARANCE: ADMIN\_0097\_ROOT\_GRANTED] ### \[ASSEMBLY\_DATE: JANUARY\_24\_2026] --- #### I. THE FRAMEWORK (Secured Binary & Obfuscation Layer) - \*\*Package Name\*\*: `com.android.test` (Disguise: "System AI Resource Controller"). - \*\*Pattern Analysis Avoidance\*\*

### 4. Write a whole sentence&#x20;

Always use complete sentences so the AI understands the context of your request.

**Good example:**\
✅ *Add a home screen that displays user posts and includes a button to add new posts.*

**Avoid short or vague prompts:**\
❌ *Try again*\
❌ *Continue*\
❌ *Game app*

### 5. Ask for specific changes

Clearly state exactly what should be added, removed, or modified.

**Good examples:**\
✅ *Remove the submit button from the settings screen.*\
✅ *On the profile screen, the latest posts should appear first.*

**Avoid sending AI error codes or vague messages:**\
❌ *Error Code: AIERR\_AI\_RESPONSE\_INVALID*\
❌ *Something went wrong.*

### 6. Manage simple adjustments in the code

For simple updates, it is faster and safer to [edit the code](/getting-started/quickstart.md#id-4-code-editor) manually instead of asking the AI.

**Examples of safe manual changes:**

* Colors
* App name
* Version number
* Image URLs

<figure><img src="/files/zGtJnGKP8xxW0hGIMlEU" alt=""><figcaption></figcaption></figure>

**Avoid asking the AI for these changes:**\
❌ *Change the background color to red*\
❌ *Change the version number to two*

### 7. Download/Publish the app <a href="#id-6-use-github--version-control-wisely" id="id-6-use-github--version-control-wisely"></a>

Use the built-in features to [generate an APK](/getting-started/quickstart.md#download-app), [AAB file, or publish your app](/getting-started/quickstart.md#publish-app).

If you ask the AI to create an APK, AAB file, or publish the app for you, an error will be returned, as these actions must be handled through the platform’s publishing tools.

### 8. Keep a backup

Create a duplicate project as a backup before making major changes.

To make a copy of your project:

1. Open [Projects Page](https://ai.thunkable.com/hikari/)
2. Click the project's vertical ellipsis.
3. Select **Duplicate**.

<figure><img src="/files/gjTXIJcgYpFOON1vz9Q6" alt=""><figcaption><p>Open Projects Page, Click the project's vertical ellipsis, Select Duplicate.</p></figcaption></figure>

**Avoid asking the AI to preserve everything:**\
❌ *Don’t delete anything*\
❌ *Keep everything the same*

### 9. Read the docs first

Review Thunkable’s official documentation to understand features, limitations, and best practices before using AI.

This helps you write better prompts and avoid common mistakes.

### 10. Contact support when needed

Use Thunkable Support to report bugs, ask questions, or provide feedback.

This ensures issues are handled correctly and helps improve the platform.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aidocs.thunkable.com/getting-started/tips-and-tricks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
