diff --git a/docs/lovable.mdx b/docs/lovable.mdx
index 5ad000b..427846d 100644
--- a/docs/lovable.mdx
+++ b/docs/lovable.mdx
@@ -11,6 +11,14 @@ import { IntegrationHeader } from '/snippets/integration-header.mdx'
   partnerHeight="32px"
 />
 
+<video
+  controls
+  loop
+  playsInline
+  className="w-full aspect-video"
+  src="/images/lovable-demo.mp4"
+/>
+
 [Lovable](https://lovable.dev/) is an AI-powered platform that lets anyone, regardless of technical skill, build full-stack web applications using natural language. Just describe what you want, and Lovable builds it for you.
 
 With Rime's text-to-speech integration, you can now add natural, lifelike voice capabilities to your Lovable apps with just a few lines in your prompt. Whether you're building a voiceover tool, an accessibility feature, or an AI assistant, getting Rime TTS into your Lovable project is surprisingly simple.
diff --git a/docs/vapi.mdx b/docs/vapi.mdx
index 54d5a86..31bfe8a 100644
--- a/docs/vapi.mdx
+++ b/docs/vapi.mdx
@@ -8,8 +8,70 @@ import { IntegrationHeader } from '/snippets/integration-header.mdx'
   partnerAlt="VAPI logo" 
 />
 
-[VAPI](https://vapi.ai/) is a voice AI platform for developers, empowering you to build, test, and deploy voice agents in minutes—not months.
+![Vapi demo](/images/vapi-demo.gif)
 
-Rime's text-to-speech synthesis (TTS) model is available via the VAPI API. With VAPI's Rime integration, you can build AI voice applications that that sound as natural as a human conversation.
+[Vapi](https://vapi.ai) is an API-first platform for building, testing, and deploying voice AI agents. It handles telephony, orchestration, and integrations so you can focus on your agent's behavior. Paired with Rime's ultra-realistic voices, you get natural-sounding conversations with sub-200ms latency. This guide walks you through creating a basic voice assistant with Vapi and Rime.
 
-More information is available in [VAPI's documentation](https://docs.vapi.ai/providers/voice/rimeai).
\ No newline at end of file
+## Prerequisites
+
+- [Vapi account](https://dashboard.vapi.ai)
+- [Rime API key](https://app.rime.ai/tokens) (optional)
+
+## Step 1: Create the assistant
+
+From the [Vapi dashboard](https://dashboard.vapi.ai), navigate to **Assistants** and press **Create Assistant**.
+
+![Vapi assistants page with Create Assistant button](/images/vapi-create-assistant-button.png)
+
+Give your assistant a name, select **Blank Template**, and click **Create Assistant**.
+
+![Create assistant modal](/images/vapi-create-assistant.png)
+
+In the **Model** tab, select your preferred LLM provider. Any option should work, but models with lower latency enable conversational flow better. Then, add a **First Message** so that your assistant can begin the conversation. Finally, configure a system prompt to define your agents personality and behavior. The system prompt can be as complex or simple as you like. For example:
+
+```
+You are a helpful voice assistant.
+Keep your responses short and conversational. No more than 2-3 sentences.
+Be friendly and natural.
+```
+
+Alternatively, use the **Generate** button and get AI help to create a well structured prompt.
+
+![Model tab configuration](/images/vapi-model.png)
+
+Next, in the **Voice** tab, configure your assistant to use **Rime AI** as the **Provider**. Then, select the **Voice** that you want your assistant to use. Find more details about Rime's voices on the [Voices page](./voices) set the **Model** to **Arcana** to use the latest Rime model with the most realistic voices.
+
+![Voice tab with Rime AI provider selected](/images/vapi-voice.png)
+
+Finally, in the **Transcriber** tab, select your preferred speech-to-text (STT) provider and then click **Publish**.
+
+![Transcriber tab configuration](/images/vapi-transcriber.png)
+
+On the publishing pop-up window, select **Skip and Publish**.
+
+![Publish pop-up window](/images/vapi-publish-popup.png)
+
+## Step 2 (optional): Add your API keys to Vapi
+
+Vapi provides API access to all it's supported models through its integrated billing plans. However, if you already have a subscription plan to one or more of your assistant's configured providers, you can enable access to these by clicking on **More** under the **Build** heading and then **Integrations**. 
+
+![Integrations](/images/vapi-integrations.png)
+
+Then, find your providers and add your API keys. These will be stored securely and automatically be used by your assistant instead of the integrated Vapi billing.
+
+![Rime API key integration](/images/vapi-rime-api-key.png)
+
+## Step 3: Test your assistant
+
+The above steps create the most basic assistant using Rime's voices.
+
+Click **Talk to Assistant** in the dashboard to start a conversation in your browser.
+
+![Vapi demo](/images/vapi-demo.gif)
+
+## Next steps
+
+- **Try different voices:** `celeste`, `orion`, `andromeda`. Audition them at [app.rime.ai](https://app.rime.ai)
+- **Add a phone number:** Provision one in the Vapi dashboard and assign it to your assistant for telephony
+- **Create a workflow:** Your assistant can be programmed to do complex tasks using the [Workflows dashboard](https://dashboard.vapi.ai/workflows).
+- **Customize the personality:** Update the system prompt to match your use case
diff --git a/images/lovable-demo.mp4 b/images/lovable-demo.mp4
new file mode 100644
index 0000000..bf144bb
Binary files /dev/null and b/images/lovable-demo.mp4 differ
diff --git a/images/vapi-create-assistant-button.png b/images/vapi-create-assistant-button.png
new file mode 100644
index 0000000..cea1af5
Binary files /dev/null and b/images/vapi-create-assistant-button.png differ
diff --git a/images/vapi-create-assistant.png b/images/vapi-create-assistant.png
new file mode 100644
index 0000000..24d53b1
Binary files /dev/null and b/images/vapi-create-assistant.png differ
diff --git a/images/vapi-demo.gif b/images/vapi-demo.gif
new file mode 100644
index 0000000..36afb20
Binary files /dev/null and b/images/vapi-demo.gif differ
diff --git a/images/vapi-integrations.png b/images/vapi-integrations.png
new file mode 100644
index 0000000..81d4232
Binary files /dev/null and b/images/vapi-integrations.png differ
diff --git a/images/vapi-model.png b/images/vapi-model.png
new file mode 100644
index 0000000..9687abd
Binary files /dev/null and b/images/vapi-model.png differ
diff --git a/images/vapi-publish-popup.png b/images/vapi-publish-popup.png
new file mode 100644
index 0000000..f0e245e
Binary files /dev/null and b/images/vapi-publish-popup.png differ
diff --git a/images/vapi-rime-api-key.png b/images/vapi-rime-api-key.png
new file mode 100644
index 0000000..688916c
Binary files /dev/null and b/images/vapi-rime-api-key.png differ
diff --git a/images/vapi-transcriber.png b/images/vapi-transcriber.png
new file mode 100644
index 0000000..92efa2a
Binary files /dev/null and b/images/vapi-transcriber.png differ
diff --git a/images/vapi-voice.png b/images/vapi-voice.png
new file mode 100644
index 0000000..891c815
Binary files /dev/null and b/images/vapi-voice.png differ