speechmatics · lgavincrl · Nov 27, 2025 · Nov 27, 2025 · Nov 27, 2025 · Nov 27, 2025
diff --git a/docs/get-started/quickstart.mdx b/docs/get-started/quickstart.mdx
@@ -4,8 +4,14 @@ pagination_next: null
 description: Take your first steps with the Speechmatics API.
 ---
 import { LinkCard } from "@site/src/theme/LinkCard";
+import DevIcon from '@site/src/components/devicon';
 import { Flex, Grid } from "@radix-ui/themes";
-import { ChevronsRightIcon, FileAudio, BotMessageSquare, BookOpen, Braces } from "lucide-react";
+import { ChevronsRightIcon, FileAudio, BotMessageSquare, BookOpen, Braces, Speech, GraduationCap } from "lucide-react";
+import Head from '@docusaurus/Head';
+
+<Head>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/devicons/devicon@latest/devicon.min.css" />
+</Head>
 
 # Quickstart
 
@@ -30,9 +36,15 @@ The easiest way to try our products is via the [web portal](https://portal.speec
   />
   <LinkCard
     title="Build a voice agent"
-    description="Build conversational AI agents with ease using the Flow API"
+    description="Build conversational AI agents with ease using the Voice SDK"
     icon={<BotMessageSquare/>}
-    href="/voice-agents-flow/"
+    href="/voice-agents/overview"
+  />
+  <LinkCard
+    title="Generate speech from text"
+    description="Use the TTS API to convert text to speech"
+    icon={<Speech/>}
+    href="/text-to-speech/quickstart"
   />
 </Flex>
 
@@ -51,4 +63,16 @@ The easiest way to try our products is via the [web portal](https://portal.speec
     icon={<Braces/>}
     href="https://github.com/speechmatics/speechmatics-js-sdk"
   />
+  <LinkCard
+    title="Python SDK"
+    description="Use our Python SDK to access all of our APIs"
+    icon={<DevIcon name="python" />}
+    href="https://github.com/speechmatics/speechmatics-python-sdk"
+  />
+  <LinkCard
+    title="Speechmatics Academy"
+    description="To learn more or see some examples, visit the Speechmatics Academy"
+    icon={<GraduationCap/>}
+    href="https://github.com/speechmatics/speechmatics-academy"
+  />
 </Grid>
diff --git a/docs/get-started/sidebar.ts b/docs/get-started/sidebar.ts
@@ -12,6 +12,7 @@ export default {
     {
       type: "doc",
       id: "get-started/quickstart",
+      label: "Quickstart",
     },
     {
       type: "doc",

diff --git a/docs/index.mdx b/docs/index.mdx
@@ -1,14 +1,14 @@
 ---
 sidebar_position: 1
 title: Welcome
-description: Enterprise-grade APIs for speech-to-text and voice AI agents.
+description: Enterprise-grade APIs for speech-to-text, text-to-speech, and voice AI agents.
 hide_table_of_contents: true
 pagination_prev: null
 pagination_next: null
 ---
 
 import { LinkCard } from "@site/src/theme/LinkCard";
-import { ChevronsRightIcon, FileAudio, BotMessageSquare, } from "lucide-react";
+import { ChevronsRightIcon, FileAudio, BotMessageSquare, Speech } from "lucide-react";
 import { Box, Flex, Card, Grid, Inset } from "@radix-ui/themes";
 
 # Welcome to Speechmatics
@@ -31,7 +31,8 @@ With Speechmatics, you can:
 
 - Receive immediate and continuous text transcriptions from live audio streams or calls (real-time transcription)
 - Generate complete transcripts from recorded audio files (batch transcription)
-- Build voice AI agents that naturally converse with your users (Flow service)
+- Build and power your applications with responsive, real-time, voice AI using our Voice SDK
+- Transform your text into speech using our Text-to-Speech API
 - Choose flexible deployment options: use our managed SaaS platform or host Speechmatics APIs within your infrastructure (on-prem)
 
 ## Developer quickstart
@@ -54,9 +55,16 @@ With Speechmatics, you can:
   <LinkCard
     icon={<BotMessageSquare/>}
     title="Build a voice agent"
-    description="Use our Flow service to build conversational AI agents with ease"
+    description="Use our Voice SDK to build voice agents with ease"
     direction="column"
-    href="/voice-agents-flow"
+    href="/voice-agents/overview"
+  />
+  <LinkCard
+    icon={<Speech/>}
+    title="Generate speech from text"
+    description="Use our TTS API to generate speech from text"
+    direction="column"
+    href="/text-to-speech/quickstart"
   />
 </Flex>
 
@@ -96,8 +104,8 @@ With Speechmatics, you can:
 <Grid columns={{initial: "1", md: "2"}} gap="3">
   <LinkCard
     title="Voice agent app"
-    description="Conversational AI with React Native and Flow"
-    href="/voice-agents-flow/guides/react-native"
+    description="Build your own responsive voice agent with our Voice SDK"
+    href="/voice-agents/overview"
   />
   <LinkCard
     title="Realtime transcription with NextJS"

diff --git a/docs/integrations-and-sdks/index.mdx b/docs/integrations-and-sdks/index.mdx
@@ -1,128 +1,109 @@
 ---
-id: Overview
-description: Discover how to connect to Speechmatics via integrations and SDKs.
+description: Discover which integrations and SDKs to add Speechmatics' STT, TTS or voice agents to your applications.
 ---
+
 import { LinkCard } from "@site/src/theme/LinkCard";
+import DevIcon from '@site/src/components/devicon';
 import { Flex, Grid } from "@radix-ui/themes";
-import { ChevronsRightIcon, FileAudio, BotMessageSquare, BookOpen, Braces } from "lucide-react";
+import {  } from "lucide-react";
+import Head from '@docusaurus/Head';
+
+<Head>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/devicons/devicon@latest/devicon.min.css" />
+</Head>
 
-Discover which integrations and SDKs to use to add Speechmatics speech and voice agents to your stack.
+
+# Overview
 
 Use this page to quickly choose how you connect to Speechmatics: through popular voice agent platforms, or directly from your code using our SDKs. Start with the option that best matches your current stack, then follow its quickstart.
 
 ## Voice agent orchestrator integrations
 
 Choose an integration to build accurate, low-latency voice agents rapidly with the Speechmatics API available in these frameworks.
 
-<Grid columns={{initial: "1", md: "2", lg: "3"}} gap="3">
+<Grid columns="3" gap="3">
   <LinkCard
     title="Vapi"
-    description="Turnkey voice agent platform. Deploy fast with no code"
-    icon={<BotMessageSquare/>}
+    description="Turnkey voice agent platform. Deploy fast with no code. Rapid prototyping. Best for: non-technical builders."
+    icon={<img src="/img/integration-logos/vapi.png" alt="Vapi logo" width="28px" height="28px" />}
     href="/integrations-and-sdks/vapi"
   />
   <LinkCard
     title="LiveKit"
-    description="Open-source framework for building agents with LiveKit’s WebRTC infra"
-    icon={<ChevronsRightIcon/>}
+    description="Open-source framework for building agents with LiveKit’s WebRTC infra. Simple setup. Best for: engineers."
+    icon={<img src="/img/integration-logos/livekit.png" alt="LiveKit logo" width="28px" height="28px" />}
     href="/integrations-and-sdks/livekit"
   />
   <LinkCard
     title="Pipecat"
-    description="Open-source framework with full control of the voice pipeline in code"
-    icon={<FileAudio/>}
-    href="/integrations-and-sdks/pipecat"
-  />
-  <LinkCard
-    title="Best for"
-    description="Non-technical builders, rapid prototyping"
-    icon={<BotMessageSquare/>}
-    href="/integrations-and-sdks/vapi" 
-  />
-  <LinkCard
-    title="Best for"
-    description="Engineers, simple setup"
-    icon={<ChevronsRightIcon/>}
-    href="/integrations-and-sdks/livekit"
-  />
-  <LinkCard
-    title="Best for:"
-    description="Power builders, complex agents"
-    icon={<FileAudio/>}
+    description="Open-source framework with full control of the voice pipeline in code. Complex agents. Best for: power builders."
+    icon={<img src="/img/integration-logos/pipecat.png" alt="Pipecat logo" width="28px" height="28px" />}
     href="/integrations-and-sdks/pipecat"
   />
+
 </Grid>
 
+
+
 ## SDKs
 
 Use an SDK if you want to call Speechmatics directly from your own services or applications.
 
 ### Speech to text
 
-<Grid columns={{initial: "1", md: "2", lg: "3"}} gap="3" row="3">
+<Grid columns="3" gap="3">
   <LinkCard
-    title="Python SDK (Voice Agents)"
-    description="Build voice agents in Python"
-    icon={<ChevronsRightIcon/>}
+    title="Voice SDK (Python)"
+    description="Build responsive voice agents"
+    icon={<DevIcon name="python" />}
     href="https://github.com/speechmatics/speechmatics-python-sdk/tree/main/sdk/voice"
   />
-  <LinkCard
-    title="Python SDK (Realtime)"
-    description="Stream audio and receive instant transcripts in Python"
-    icon={<BotMessageSquare/>}
+   <LinkCard
+    title="Realtime (Python)"
+    description="Stream audio and receive instant transcripts"
+    icon={<DevIcon name="python" />}
     href="https://github.com/speechmatics/speechmatics-python-sdk/tree/main/sdk/rt"
   />
-    <LinkCard
-    title="JavaScript SDK (Realtime)"
-    description="Stream audio and receive instant transcripts in JavaScript"
-    icon={<BotMessageSquare/>}
-    href="https://github.com/speechmatics/speechmatics-javascript-sdk/tree/main/sdk/rt"
-  />
-  <LinkCard
-    title=".NET SDK (Realtime)"
-    description="Stream audio and receive instant transcripts in .NET"
-    icon={<FileAudio/>}
-    href="https://github.com/speechmatics/speechmatics-dotnet-community-sdk"
-  />
-<LinkCard
-    title="Python SDK (Batch)"
-    description="Input audio files and receive transcripts in Python"
-    icon={<ChevronsRightIcon/>}
+   <LinkCard
+    title="Batch (Python)"
+    description="Input audio files and receive transcripts"
+    icon={<DevIcon name="python" />}
     href="https://github.com/speechmatics/speechmatics-python-sdk/tree/main/sdk/batch"
   />
   <LinkCard
-    title="JavaScript SDK (Batch)"
-    description="Input audio files and receive transcripts in JavaScript"
-    icon={<ChevronsRightIcon/>}
+    title="Realtime (JavaScript)"
+    description="Stream audio and receive instant transcripts"
+    icon={<DevIcon name="javascript" />}
+    href="https://github.com/speechmatics/speechmatics-javascript-sdk/tree/main/sdk/rt"
+  />
+    <LinkCard
+    title="Batch (JavaScript)"
+    description="Input audio files and receive transcripts"
+    icon={<DevIcon name="javascript" />}
     href="https://github.com/speechmatics/speechmatics-javascript-sdk/tree/main/sdk/batch"
   />
   <LinkCard
-    title="Rust SDK (Realtime & batch)"
-    description="Input audio files and receive transcripts in Rust"
-    icon={<FileAudio/>}
+    title="Realtime (.NET)"
+    description="Stream audio and receive instant transcripts"
+    icon={<DevIcon name="dot-net" />}
+    href="https://github.com/speechmatics/speechmatics-dotnet-community-sdk"
+  /> 
+  <LinkCard
+    title="Realtime and Batch (Rust)"
+    description="Input audio files and receive transcripts"
+    icon={<DevIcon name="rust" />}
     href="https://github.com/speechmatics/speechmatics-rust-sdk"
   />
 </Grid>
 
 
 ### Text to speech
 
-<Grid columns={{initial: "1", md: "2", lg: "3"}} gap="3">
+<Grid columns="3" gap="3">
 <LinkCard
-    title="Python SDK (TTS)"
-    description="Convert text to speech in Python"
-    icon={<ChevronsRightIcon/>}
+    title="TTS (Python)"
+    description="Convert text to speech"
+    icon={<DevIcon name="python" />}
     href="https://github.com/speechmatics/speechmatics-python-sdk/tree/main/sdk/tts"
   />
 </Grid>
-
-### Voice SDK
-
-<Grid columns={{initial: "1", md: "2", lg: "3"}} gap="3">
-<LinkCard
-    title="Python SDK (Voice)"
-    description="Build voice agents in Python"
-    icon={<ChevronsRightIcon/>}
-    href="https://github.com/speechmatics/speechmatics-python-sdk/blob/main/sdk/voice/README.md"
-  />
-</Grid>