> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Mistakes & Best Practices

> Avoid the most common mistakes users make when using Runable and learn the best practices for building with AI.

# Common Mistakes & Best Practices

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-hero.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=85ce81722c65e7cbd4e6e6b242c4ce39" alt="Common Mistake Hero" width="1920" height="1080" data-path="images/common-mistake-hero.png" />
</Frame>

Whether you're building websites, applications, documents, videos, or images, following these recommendations will help you get better results while saving both time and credits.

***

# Mistake 1: Giving Very Short Prompts

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-short-prompts.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=f32cfe001ac36b66e71b2fc565f6b471" alt="Common Mistake Short Prompts" width="1920" height="1080" data-path="images/common-mistake-short-prompts.png" />
</Frame>

## ❌ Instead of

```text theme={null}
Build me a website.
```

## ✅ Try

```text theme={null}
Build a SaaS landing page.

Requirements:

• React + Tailwind
• Dark Mode
• Hero Section
• Pricing
• FAQ
• Contact Page
• Mobile Responsive
• Blue branding

Do not use placeholder content.
```

The more context you provide, the better the AI understands your request.

***

# Mistake 2: Asking AI To Rewrite Everything

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-rewrite.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=c4a1f57c909acc7dab6f988a724efca3" alt="Common Mistake Rewrite" width="1920" height="1080" data-path="images/common-mistake-rewrite.png" />
</Frame>

Avoid prompts like:

```text theme={null}
Rewrite my whole application.
```

Large changes increase the chance of:

* unnecessary modifications
* broken layouts
* difficult reviews
* additional iterations

Instead:

* Improve one page
* Update one component
* Add one feature
* Fix one bug

***

# Mistake 3: Not Protecting Existing Code

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-protect-code.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=4e17bd5ba3336a1e52f8738e6452e665" alt="Common Mistake Protect Code" width="1920" height="1080" data-path="images/common-mistake-protect-code.png" />
</Frame>

Always tell the AI what **should not change**.

Example:

```text theme={null}
Only update the dashboard.

Do NOT modify:

- Authentication
- Routing
- Database
- API
- Existing UI
```

***

# Mistake 4: Regenerating Instead of Refining

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-refine.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=6f03f8fc1399ada64169f94ae5cf897a" alt="Common Mistake Refine" width="1920" height="1080" data-path="images/common-mistake-refine.png" />
</Frame>

Instead of pressing **Generate** repeatedly:

Improve your previous prompt.

Tell the AI:

* what you liked
* what should change
* what should stay

This usually produces much better results.

***

# Mistake 5: Large Projects In One Prompt

Large projects should be built step by step.

Example roadmap:

1. Navigation
2. Homepage
3. Authentication
4. Dashboard
5. Settings
6. API
7. Deployment

Smaller changes are easier to review.

***

# Mistake 6: Forgetting To Test

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-testing.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=afc5842a01a57c959199c6be88822aa7" alt="Common Mistake Testing" width="1920" height="1080" data-path="images/common-mistake-testing.png" />
</Frame>

Always test:

* Preview
* Mobile
* Desktop
* Forms
* Authentication
* APIs
* Payments
* Publishing

before deploying.

***

# Mistake 7: Not Using Preview

Preview lets you verify changes before publishing.

Always:

1. Generate
2. Preview
3. Test
4. Publish

***

# Mistake 8: Expecting AI To Read Your Mind

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-context-1.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=1bdc2423860774a734bc26865e0e6f7c" alt="Common Mistake Context 1" width="1920" height="1080" data-path="images/common-mistake-context-1.png" />
</Frame>

AI only knows:

* your prompt
* uploaded files
* project context

It cannot infer:

* your preferences
* hidden requirements
* future plans

Always explain your goal clearly.

***

# Mistake 9: Ignoring Credit Usage

Large requests usually require more computation.

Instead of

```text theme={null}
Build an entire CRM.
```

Start with

```text theme={null}
Create authentication.

↓

Dashboard.

↓

Customers.

↓

Invoices.

↓

Reports.
```

This gives you better control over quality and credit usage.

***

# Mistake 10: Using Images Without References

Reference images dramatically improve image generation.

Good workflow:

Reference Image

Detailed Prompt

↓

Much Better Results

***

# Mistake 11: Using Long Videos With Lots Of Text

Current AI video models work best with:

* short scenes
* minimal text
* readable subtitles
* clear instructions

Avoid large paragraphs of text inside videos.

***

# Mistake 12: Publishing Without Reviewing

Always verify:

* Layout
* Mobile responsiveness
* Links
* Forms
* Images
* Authentication
* SEO
* Accessibility

before publishing.

***

# Mistake 13: Confusing Top-Ups With Subscriptions

A very common misunderstanding.

**Subscription**

* Monthly payment
* Monthly credits
* Hosting
* AI access

**Top-Up Credits**

* One-time purchase
* Never expire
* Do not renew your subscription
* Do not change your billing cycle

***

# Mistake 14: Cancelling After Renewal

Subscriptions renew automatically on your billing date.

If you don't wish to continue, cancel **before** your next renewal.

Navigate to:

```text theme={null}
Settings
→ Account
→ Manage Plan
→ Manage
→ Cancel Subscription
```

***

# Mistake 15: Letting Projects Become Too Large

As projects grow:

* architecture becomes more complex
* prompts become harder
* AI needs more context

Regularly:

* organize components
* remove unused code
* keep project structure clean

***

# Best Practices

<CardGroup cols={2}>
  <Card title="Give Context">
    Explain your project before asking for changes.
  </Card>

  <Card title="One Task At A Time">
    Small prompts usually produce better results.
  </Card>

  <Card title="Protect Existing Code">
    Tell AI what should remain unchanged.
  </Card>

  <Card title="Use Preview">
    Always preview before publishing.
  </Card>

  <Card title="Review Everything">
    AI-generated content should always be reviewed.
  </Card>

  <Card title="Iterate">
    Improve previous prompts instead of starting over.
  </Card>

  <Card title="Use References">
    Reference images improve quality significantly.
  </Card>

  <Card title="Keep Projects Organized">
    Clean projects are easier for AI to understand.
  </Card>
</CardGroup>

***

# Checklist Before Clicking Generate

<Frame>
  <img src="https://mintcdn.com/runableinc/7nys-NXylB0_Lnox/images/common-mistake-checklist.png?fit=max&auto=format&n=7nys-NXylB0_Lnox&q=85&s=8c2331f14f30981fadd7f45bb572a64a" alt="Common Mistake Checklist" width="1920" height="1080" data-path="images/common-mistake-checklist.png" />
</Frame>

✅ Did I explain my goal?

✅ Did I give enough context?

✅ Did I specify the framework?

✅ Did I protect existing code?

✅ Did I mention what shouldn't change?

✅ Am I changing only one feature?

✅ Did I upload references if needed?

✅ Will I preview before publishing?

***

# Related Guides

* Prompt Engineering Guide
* AI Limitations
* Understanding Credit Usage
* Image Generation
* Website Hosting
