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

# Custom Domains

> Learn how to connect your own custom domain to VibeFlow

Connect your VibeFlow applications to your own custom domain for a professional and branded user experience.

## Why Use Custom Domains?

Using a custom domain with VibeFlow offers several benefits:

* **Strengthen your brand identity:** Use a domain that reflects your business name
* **Build user trust:** A familiar web address increases credibility and confidence
* **Seamless integration:** Make VibeFlow part of your existing web presence
* **Professional appearance:** Create a polished, personalized experience for your users

## Prerequisites

Before setting up a custom domain, make sure you have:

* An active VibeFlow paid plan
* Access to your domain's DNS settings (available through your domain registrar like GoDaddy, Namecheap, or Google Domains)

## How to Set Up a Custom Domain

Custom domains are configured at the project level. Follow these simple steps to connect your domain:

### Step 1: Navigate to Your Project Settings

* Open your VibeFlow project
* Click on the **Settings** tab
* Select the **Custom Domains** section

### Step 2: Enter Your Domain

* Enter your full domain name (e.g., `mycoolproject.com` or `app.mycoolproject.com`)
* **Note:** If you want to use `www` in your domain (like `www.mycoolproject.com`), you must enter it manually

### Step 3: Copy Your DNS Records

After entering your domain, VibeFlow will generate DNS records for you:

* **TXT record:** Used to verify that you own the domain
* **A records:** Points your domain to VibeFlow's servers (we use Freestyle as our DNS provider)

Copy both records-you'll need them in the next step.

### Step 4: Add Records to Your DNS Settings

* Log in to your domain registrar's website (where you purchased your domain)
* Find the **DNS Management** or **DNS Settings** section
* Add the TXT and A records you copied from VibeFlow
* Save your changes

### Step 5: Wait for DNS Propagation

* DNS changes can take **up to 48 hours** to fully propagate across the internet
* Most changes take effect within a few hours
* You can check the status in your VibeFlow project settings

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How long does it take for my custom domain to work?">
    DNS propagation typically takes anywhere from a few minutes to 48 hours. Most domains are active within 2-6 hours.
  </Accordion>

  <Accordion title="Can I use a subdomain instead of my main domain?">
    Yes! You can use any subdomain (like `app.yourdomain.com` or `portal.yourdomain.com`). Just enter the full subdomain when setting up your custom domain.
  </Accordion>

  <Accordion title="Do I need to configure SSL/HTTPS certificates?">
    No. VibeFlow automatically handles SSL certificate provisioning and renewal for your custom domain. Your site will be secured with HTTPS.
  </Accordion>

  <Accordion title="⚠️ Important: Do I need to disable Cloudflare Proxy?">
    **Yes! If you use Cloudflare for your domain, you must disable the proxy (orange cloud) for your VibeFlow DNS records.**

    When the Cloudflare proxy is enabled, it can interfere with DNS verification and cause your custom domain setup to fail.

    To fix this:

    1. Log in to your Cloudflare dashboard
    2. Find the DNS records you added for VibeFlow
    3. Click the orange cloud icon to turn it **gray** (DNS only)
    4. Save your changes
  </Accordion>

  <Accordion title="What if my custom domain isn't working?">
    If your domain isn't connecting after 48 hours:

    * Double-check that the TXT and A records were entered correctly
    * Ensure there are no typos in the DNS records
    * Verify that Cloudflare proxy is **disabled** if you use Cloudflare
    * Contact VibeFlow support for assistance
  </Accordion>

  <Accordion title="Can I use multiple custom domains for one project?">
    Yes! VibeFlow allows you to add multiple custom domains to a single project. Just repeat the setup process for each domain you want to connect.
  </Accordion>

  <Accordion title="Can I use an apex domain (without www)?">
    Yes! You can use either an apex domain (like `yourdomain.com`) or a subdomain (like `www.yourdomain.com` or `app.yourdomain.com`). Just make sure to enter the exact domain format you want to use.
  </Accordion>

  <Accordion title="What happens to my old VibeFlow URL?">
    Your original VibeFlow URL (e.g., `yourproject.vibeflow.build`) will continue to work even after you set up a custom domain. Both URLs will point to your project.
  </Accordion>
</AccordionGroup>