> ## Documentation Index
> Fetch the complete documentation index at: https://base-a060aa97-eb-mini-app-ia-overhaul.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy

> Get a stable HTTPS URL for testing your Mini App in Farcaster

To test as a Mini App, you need a live HTTPS URL.

## Deploy to Vercel (recommended)

<Steps>
  <Step title="Install Vercel CLI">
    ```bash
    npm install -g vercel
    ```
  </Step>

  <Step title="Deploy">
    ```bash
    vercel
    ```
  </Step>

  <Step title="Set environment variables">
    Use `vercel env add` or the dashboard to add:

    * NEXT\_PUBLIC\_CDP\_CLIENT\_API\_KEY
    * NEXT\_PUBLIC\_URL (deployed app URL)
    * NEXT\_PUBLIC\_IMAGE\_URL (optional)
    * NEXT\_PUBLIC\_SPLASH\_IMAGE\_URL (optional)
    * NEXT\_PUBLIC\_SPLASH\_BACKGROUND\_COLOR (optional)
  </Step>
</Steps>

Then verify your URL works in a browser and proceed to manifest creation.

## Alternative: ngrok (for local testing)

<AccordionGroup>
  <Accordion title="Using ngrok">
    <Warning>
      The paid plan is recommended. The free approval screen and rotating URLs can break the manifest.
    </Warning>

    1. Start your dev server:

    ```bash Terminal
    npm run dev
    ```

    2. Create a tunnel:

    ```bash Terminal
    npm install -g ngrok
    ngrok http 3000
    ```

    3. Copy the HTTPS URL (e.g. `https://your-tunnel.ngrok.io`)
    4. Use that URL during manifest creation
  </Accordion>
</AccordionGroup>

<Card title="Create your manifest" icon="id-badge" href="/mini-apps/quickstart/build-a-mini-app/create-manifest">
  Generate account association and set frame metadata
</Card>