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

# Getting Started

> Start your journey with BubblaV in minutes

Welcome to BubblaV! This guide will help you create your account, set up your first chatbot, and get it live on your website in under 10 minutes.

## What You'll Need

Before starting, have these ready:

* An email address (or Google account)
* Your website URL
* A few minutes of your time

***

## Step 1: Create an Account

<Steps>
  <Step title="Visit Sign Up">
    Go to [bubblav.com/login](https://www.bubblav.com/login)
  </Step>

  <Step title="Choose Sign Up Method">
    Pick your preferred option:

    * **Email**: Enter email and create a password
    * **Google**: One-click sign up with your Google account
  </Step>

  <Step title="Verify Email">
    If using email, check your inbox and click the verification link
  </Step>

  <Step title="Access Dashboard">
    You'll be redirected to your dashboard automatically
  </Step>
</Steps>

<Tip>
  Using Google is fastest—no email verification needed.
</Tip>

***

## Step 2: Choose Your Plan

BubblaV offers plans for every business size:

| Feature                    | Free   | Pro (\$49/mo)                | Turbo (\$99/mo)              |
| -------------------------- | ------ | ---------------------------- | ---------------------------- |
| **Messages/month**         | 100    | 5,000                        | 15,000                       |
| **Pages crawled**          | 50     | 5,000                        | 50,000                       |
| **Websites**               | 1      | 5                            | 20                           |
| **Team members**           | 1      | 3                            | 10                           |
| **Human handoff**          | Yes    | Yes                          | Yes                          |
| **Email to visitors**      | Yes    | Yes                          | Yes                          |
| **Live Support**           | -      | Yes                          | Yes                          |
| **Custom Tools**           | Yes    | Yes                          | Yes                          |
| **Remove branding**        | -      | Yes                          | Yes                          |
| **Conversation retention** | 7 days | 1 year                       | 2 years                      |
| **Annual billing**         | -      | \$39/month (save \$120/year) | \$79/month (save \$240/year) |

<Note>
  Start with the **Free** plan to test everything. The **Pro** plan includes a **14-day free trial**—full access during the trial, cancel anytime at no cost. Annual billing saves 20% on all paid plans.
</Note>

### Upgrading Later

1. Click your **user avatar** in the top-right corner
2. Select **Subscription** from the menu
3. Click **Upgrade Plan**
4. Select your desired plan
5. Enter payment details
6. Your new limits apply immediately

***

## Step 3: Create Your First Website

<Steps>
  <Step title="Click New Website">
    From the dashboard, click **+ New Website**
  </Step>

  <Step title="Enter Website URL">
    The full URL of your site (e.g., `https://example.com`)
  </Step>

  <Step title="Click Add">
    Your website is created and ready to configure. We'll automatically fetch your favicon and site name if available.
  </Step>
</Steps>

### What Happens Next

After creating your website:

1. **Automatic crawl begins**: BubblaV scans your website to learn about your business
2. **Knowledge base populates**: Content from your pages is indexed
3. **Widget is generated**: A unique embed code is created for you

<Info>
  Crawling typically takes 2-5 minutes depending on your website size. You can continue setup while it runs.
</Info>

***

## Step 4: Setup Wizard

The setup wizard guides you through essential configuration:

### Crawl Status

Monitor your website crawl:

* **In Progress**: Pages are being scanned
* **Completed**: All pages indexed successfully
* **Errors**: Some pages couldn't be accessed

### Design Preview

Quick customization in the **Design** tab:

* Choose your **brand colors**
* Select a **position** (bottom-right or bottom-left)
* Customize **bot identity** (Name, Avatar, Welcome Message)
* Preview how it looks in real-time

### Installation Code

Get your embed code:

```html theme={null}
<script
  src="https://www.bubblav.com/widget.js"
  data-site-id="YOUR_WEBSITE_ID"
  async
></script>
```

***

## Step 5: Test Your Chatbot

Before going live, test your chatbot:

<Steps>
  <Step title="Open Design & Preview">
    Click **Design** in the sidebar to open the widget configuration and live preview.
  </Step>

  <Step title="Ask Questions">
    Try questions your customers might ask:

    * "What are your shipping options?"
    * "How do I contact support?"
    * "What products do you sell?"
  </Step>

  <Step title="Check Responses">
    Verify the answers are accurate and helpful
  </Step>

  <Step title="Adjust if Needed">
    If answers are wrong, add content to your knowledge base
  </Step>
</Steps>

***

## Quick Start Checklist

Track your progress through setup:

<AccordionGroup>
  <Accordion title="Account created">
    Sign up and verify your email
  </Accordion>

  <Accordion title="Website added">
    Create your first website in the dashboard
  </Accordion>

  <Accordion title="Crawl completed">
    Wait for your website content to be indexed
  </Accordion>

  <Accordion title="Widget designed">
    Customize colors and appearance to match your brand
  </Accordion>

  <Accordion title="Chatbot tested">
    Verify responses are accurate in preview mode
  </Accordion>

  <Accordion title="Code installed">
    Add the widget code to your website
  </Accordion>

  <Accordion title="Live verification">
    Confirm the widget appears on your live site
  </Accordion>
</AccordionGroup>

***

## Common First Steps

After basic setup, consider these enhancements:

### Improve AI Knowledge

<CardGroup cols={2}>
  <Card title="Upload Files" icon="file-arrow-up" href="/user-guide/knowledge/files">
    Add PDFs, documents with detailed info
  </Card>

  <Card title="Add Q&A" icon="file-lines" href="/user-guide/knowledge/q-a">
    Add specific answers for common questions
  </Card>
</CardGroup>

### Customize Experience

<CardGroup cols={2}>
  <Card title="Design Widget" icon="palette" href="/user-guide/widget-design">
    Match your brand colors and style
  </Card>

  <Card title="Configure Settings" icon="gear" href="/user-guide/settings">
    Set AI tone, language, notifications
  </Card>
</CardGroup>

### Connect Integrations

<CardGroup cols={3}>
  <Card title="Shopify" icon="shopify" href="/user-guide/integrations/shopify">
    Connect for order lookups
  </Card>

  <Card title="Calendly" icon="calendar" href="/user-guide/integrations/calendly">
    Enable appointment booking
  </Card>

  <Card title="View All" icon="arrow-right" href="/user-guide/integrations/overview">
    See all integrations
  </Card>
</CardGroup>

***

## Troubleshooting Setup

<AccordionGroup>
  <Accordion title="Email verification not received">
    * Check your spam/junk folder
    * Ensure you entered the correct email
    * Request a new verification email
    * Try signing up with Google instead
  </Accordion>

  <Accordion title="Crawl taking too long">
    * Large websites take longer (100+ pages)
    * Check if your site blocks bots (robots.txt)
    * Try adding pages manually if crawl fails
  </Accordion>

  <Accordion title="Widget not appearing in preview">
    * Refresh the page
    * Clear browser cache
    * Check browser console for errors
    * Ensure JavaScript is enabled
  </Accordion>

  <Accordion title="Chatbot gives wrong answers">
    * Review what content was crawled
    * Add missing information via Q\&A entries
    * Check "Content Gaps" for common unanswered questions
  </Accordion>
</AccordionGroup>

***

## Getting Help

Need assistance? Here's how to get help:

* **Documentation**: You're already here! Browse the guides.
* **Email Support**: Contact [support@bubblav.com](mailto:support@bubblav.com)
* **Live Chat**: Chat with our bot on [bubblav.com](https://www.bubblav.com)

<Tip>
  Pro and Turbo plans include priority support with faster response times.
</Tip>

***

## Next Steps

Ready to continue? Here's what to do next:

<CardGroup cols={2}>
  <Card title="Install Widget" icon="download" href="/user-guide/installation">
    Add the chatbot to your website
  </Card>

  <Card title="Train Your AI" icon="brain" href="/user-guide/knowledge/overview">
    Add more knowledge for better answers
  </Card>
</CardGroup>