` / `` elements
+
+### 3. Navigation Structure
+Created `meta.json` files for each folder:
+- `content/docs/meta.json` - Root documentation
+- `content/docs/overview/meta.json` - Overview pages
+- `content/docs/api/meta.json` - API reference
+- `content/docs/developer/meta.json` - Developer docs
+- `content/docs/plans/meta.json` - Plans/roadmap
+
+### 4. Link Fixes
+- Fixed incorrect `/guides/...` paths → `/overview/...`
+- All internal links now use correct paths
+
+### 5. Branding
+- Updated `lib/layout.shared.tsx` to use "Voicebox" as the nav title
+
+## File Structure
+
+```
+docs2/
+├── components/
+│ └── mintlify-compat.tsx # Mintlify → Fumadocs component mappings
+├── content/docs/
+│ ├── meta.json # Root navigation
+│ ├── overview/ # 12 MDX files
+│ ├── api/ # 5 MDX files
+│ ├── developer/ # 12 MDX files
+│ ├── plans/ # 4 MD files
+│ └── *.md # 4 root markdown files
+├── public/
+│ ├── images/ # 3 webp files
+│ └── logo/ # 2 png files
+└── mdx-components.tsx # MDX component configuration
+```
+
+## Icon Mapping
+
+The following icon strings are mapped to Lucide icons:
+- `microphone` → Mic
+- `film` → Film
+- `code` → Code
+- `shield` → Shield
+- `download` → Download
+- `rocket` → Rocket
+- `apple` → Apple
+- `windows` → Windows
+- `server` → Server
+- `user` → User
+- `waveform` → Waveform
+
+## Next Steps
+
+1. **Test the build**: Run `npm run build` (requires Node.js >= 20.9.0)
+2. **Start dev server**: Run `npm run dev` to preview
+3. **Customize styling**: Update `app/global.css` if needed
+4. **Add more icons**: Extend `iconMap` in `mintlify-compat.tsx` as needed
+5. **Review navigation**: Adjust `meta.json` files to customize page order
+
+## Notes
+
+- Image paths (`/images/...`) work as-is since Next.js serves from `public/`
+- All Mintlify components are now compatible with Fumadocs
+- Navigation structure follows Fumadocs conventions
+- No breaking changes to content - all MDX files work with compatibility layer
diff --git a/docs/README.md b/docs/README.md
index ee3b91c6..68109407 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,64 +1,45 @@
-# Voicebox Documentation
+# fumadocs-ui-template
-This directory contains the documentation for Voicebox, built with [Mintlify](https://mintlify.com).
+This is a Next.js application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
-## Development
-
-### Prerequisites
-
-Install Mintlify globally using bun:
+Run development server:
```bash
-bun add -g mintlify
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
```
-Or use the helper script:
+Open http://localhost:3000 with your browser to see the result.
-```bash
-bun run install:mintlify
-```
+## Explore
-### Running Locally
+In the project, you can see:
-```bash
-bun run dev
-```
+- `lib/source.ts`: Code for content source adapter, [`loader()`](https://fumadocs.dev/docs/headless/source-api) provides the interface to access your content.
+- `lib/layout.shared.tsx`: Shared options for layouts, optional but preferred to keep.
-This will start the Mintlify dev server.
+| Route | Description |
+| ------------------------- | ------------------------------------------------------ |
+| `app/(home)` | The route group for your landing page and other pages. |
+| `app/docs` | The documentation layout and pages. |
+| `app/api/search/route.ts` | The Route Handler for search. |
-The docs will be available at `http://localhost:3000`
+### Fumadocs MDX
-### Structure
+A `source.config.ts` config file has been included, you can customise different options like frontmatter schema.
-```
-docs/
-├── mint.json # Mintlify configuration
-├── custom.css # Custom styles
-├── overview/ # Getting started & feature docs
-├── guides/ # User guides
-├── api/ # API reference
-├── development/ # Developer documentation
-├── logo/ # Logo assets
-└── public/ # Static assets
-```
+Read the [Introduction](https://fumadocs.dev/docs/mdx) for further details.
-### Writing Docs
-
-- Use `.mdx` files for all documentation pages
-- Follow the existing structure in `mint.json` for navigation
-- Use Mintlify components for enhanced formatting (Card, CardGroup, Accordion, etc.)
-- Reference the [Mintlify documentation](https://mintlify.com/docs) for available components
-
-## Deployment
-
-Docs are automatically deployed when changes are pushed to the main branch.
-
-To manually deploy:
-
-```bash
-mintlify deploy
-```
+## Learn More
-## Contributing
+To learn more about Next.js and Fumadocs, take a look at the following
+resources:
-See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines.
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js
+ features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+- [Fumadocs](https://fumadocs.dev) - learn about Fumadocs
diff --git a/docs/api/authentication.mdx b/docs/api/authentication.mdx
deleted file mode 100644
index e4e72808..00000000
--- a/docs/api/authentication.mdx
+++ /dev/null
@@ -1,55 +0,0 @@
----
-title: "Authentication"
-description: "API authentication and security"
----
-
-## Current Status
-
-
` elements
+
+### 3. Navigation Structure
+Created `meta.json` files for each folder:
+- `content/docs/meta.json` - Root documentation
+- `content/docs/overview/meta.json` - Overview pages
+- `content/docs/api/meta.json` - API reference
+- `content/docs/developer/meta.json` - Developer docs
+- `content/docs/plans/meta.json` - Plans/roadmap
+
+### 4. Link Fixes
+- Fixed incorrect `/guides/...` paths → `/overview/...`
+- All internal links now use correct paths
+
+### 5. Branding
+- Updated `lib/layout.shared.tsx` to use "Voicebox" as the nav title
+
+## File Structure
+
+```
+docs2/
+├── components/
+│ └── mintlify-compat.tsx # Mintlify → Fumadocs component mappings
+├── content/docs/
+│ ├── meta.json # Root navigation
+│ ├── overview/ # 12 MDX files
+│ ├── api/ # 5 MDX files
+│ ├── developer/ # 12 MDX files
+│ ├── plans/ # 4 MD files
+│ └── *.md # 4 root markdown files
+├── public/
+│ ├── images/ # 3 webp files
+│ └── logo/ # 2 png files
+└── mdx-components.tsx # MDX component configuration
+```
+
+## Icon Mapping
+
+The following icon strings are mapped to Lucide icons:
+- `microphone` → Mic
+- `film` → Film
+- `code` → Code
+- `shield` → Shield
+- `download` → Download
+- `rocket` → Rocket
+- `apple` → Apple
+- `windows` → Windows
+- `server` → Server
+- `user` → User
+- `waveform` → Waveform
+
+## Next Steps
+
+1. **Test the build**: Run `npm run build` (requires Node.js >= 20.9.0)
+2. **Start dev server**: Run `npm run dev` to preview
+3. **Customize styling**: Update `app/global.css` if needed
+4. **Add more icons**: Extend `iconMap` in `mintlify-compat.tsx` as needed
+5. **Review navigation**: Adjust `meta.json` files to customize page order
+
+## Notes
+
+- Image paths (`/images/...`) work as-is since Next.js serves from `public/`
+- All Mintlify components are now compatible with Fumadocs
+- Navigation structure follows Fumadocs conventions
+- No breaking changes to content - all MDX files work with compatibility layer
diff --git a/docs/README.md b/docs/README.md
index ee3b91c6..68109407 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,64 +1,45 @@
-# Voicebox Documentation
+# fumadocs-ui-template
-This directory contains the documentation for Voicebox, built with [Mintlify](https://mintlify.com).
+This is a Next.js application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
-## Development
-
-### Prerequisites
-
-Install Mintlify globally using bun:
+Run development server:
```bash
-bun add -g mintlify
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
```
-Or use the helper script:
+Open http://localhost:3000 with your browser to see the result.
-```bash
-bun run install:mintlify
-```
+## Explore
-### Running Locally
+In the project, you can see:
-```bash
-bun run dev
-```
+- `lib/source.ts`: Code for content source adapter, [`loader()`](https://fumadocs.dev/docs/headless/source-api) provides the interface to access your content.
+- `lib/layout.shared.tsx`: Shared options for layouts, optional but preferred to keep.
-This will start the Mintlify dev server.
+| Route | Description |
+| ------------------------- | ------------------------------------------------------ |
+| `app/(home)` | The route group for your landing page and other pages. |
+| `app/docs` | The documentation layout and pages. |
+| `app/api/search/route.ts` | The Route Handler for search. |
-The docs will be available at `http://localhost:3000`
+### Fumadocs MDX
-### Structure
+A `source.config.ts` config file has been included, you can customise different options like frontmatter schema.
-```
-docs/
-├── mint.json # Mintlify configuration
-├── custom.css # Custom styles
-├── overview/ # Getting started & feature docs
-├── guides/ # User guides
-├── api/ # API reference
-├── development/ # Developer documentation
-├── logo/ # Logo assets
-└── public/ # Static assets
-```
+Read the [Introduction](https://fumadocs.dev/docs/mdx) for further details.
-### Writing Docs
-
-- Use `.mdx` files for all documentation pages
-- Follow the existing structure in `mint.json` for navigation
-- Use Mintlify components for enhanced formatting (Card, CardGroup, Accordion, etc.)
-- Reference the [Mintlify documentation](https://mintlify.com/docs) for available components
-
-## Deployment
-
-Docs are automatically deployed when changes are pushed to the main branch.
-
-To manually deploy:
-
-```bash
-mintlify deploy
-```
+## Learn More
-## Contributing
+To learn more about Next.js and Fumadocs, take a look at the following
+resources:
-See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines.
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js
+ features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+- [Fumadocs](https://fumadocs.dev) - learn about Fumadocs
diff --git a/docs/api/authentication.mdx b/docs/api/authentication.mdx
deleted file mode 100644
index e4e72808..00000000
--- a/docs/api/authentication.mdx
+++ /dev/null
@@ -1,55 +0,0 @@
----
-title: "Authentication"
-description: "API authentication and security"
----
-
-## Current Status
-
-
- Authentication is not currently implemented in Voicebox. The API is intended for local use only.
-
-
-## Local Usage
-
-For local development and usage:
-- API runs on `localhost:17493`
-- No authentication required
-- Access restricted to local machine
-
-## Future Implementation
-
-Authentication will be added in a future release for:
-- Remote deployments
-- Multi-user access
-- Production environments
-
-Planned authentication methods:
-- API keys
-- OAuth 2.0
-- JWT tokens
-
-## Security Best Practices
-
-Until authentication is implemented:
-
-
-
- Use WireGuard or Tailscale for remote access
-
-
- Run behind nginx with basic auth
-
-
- Restrict access to trusted IPs only
-
-
- Don't expose to public internet
-
-
-
-## Coming Soon
-
-- API key management
-- User accounts
-- Rate limiting
-- Access control
diff --git a/docs/api/generation.mdx b/docs/api/generation.mdx
deleted file mode 100644
index c9fff59c..00000000
--- a/docs/api/generation.mdx
+++ /dev/null
@@ -1,119 +0,0 @@
----
-title: "Generation API"
-description: "Generate speech from text"
----
-
-## Generate Speech
-
-```http
-POST /generate
-```
-
-**Request:**
-```json
-{
- "text": "Hello world",
- "profile_id": "abc123",
- "language": "en"
-}
-```
-
-**Response:**
-```json
-{
- "id": "gen123",
- "text": "Hello world",
- "profile_id": "abc123",
- "language": "en",
- "audio_url": "/audio/gen123.wav",
- "duration": 2.3,
- "created_at": "2024-01-29T12:00:00Z"
-}
-```
-
-## List History
-
-```http
-GET /history
-```
-
-**Query Parameters:**
-- `profile_id` (optional) - Filter by voice profile
-- `limit` (optional) - Number of results (default: 50)
-- `offset` (optional) - Pagination offset
-
-**Response:**
-```json
-{
- "generations": [
- {
- "id": "gen123",
- "text": "Hello world",
- "profile_id": "abc123",
- "duration": 2.3,
- "created_at": "2024-01-29T12:00:00Z"
- }
- ],
- "total": 100
-}
-```
-
-## Get Generation
-
-```http
-GET /history/{id}
-```
-
-**Response:**
-```json
-{
- "id": "gen123",
- "text": "Hello world",
- "profile_id": "abc123",
- "language": "en",
- "audio_url": "/audio/gen123.wav",
- "duration": 2.3,
- "created_at": "2024-01-29T12:00:00Z"
-}
-```
-
-## Delete Generation
-
-```http
-DELETE /history/{id}
-```
-
-**Response:**
-```json
-{
- "success": true
-}
-```
-
-## TypeScript Example
-
-```typescript
-import { VoiceboxClient } from '@/lib/api'
-
-const client = new VoiceboxClient({
- baseUrl: 'http://localhost:17493'
-})
-
-// Generate speech
-const generation = await client.generate({
- text: 'Hello world',
- profile_id: 'abc123',
- language: 'en'
-})
-
-// Get audio URL
-const audioUrl = generation.audio_url
-
-// List history
-const history = await client.listHistory({
- profile_id: 'abc123',
- limit: 20
-})
-```
-
-For full API documentation, visit `http://localhost:17493/docs` when the server is running.
diff --git a/docs/api/overview.mdx b/docs/api/overview.mdx
deleted file mode 100644
index c862a332..00000000
--- a/docs/api/overview.mdx
+++ /dev/null
@@ -1,219 +0,0 @@
----
-title: "API Overview"
-description: "Integrate voice synthesis into your applications with the Voicebox REST API"
----
-
-## Introduction
-
-Voicebox exposes a full REST API that allows you to integrate voice synthesis into your own applications. The API runs on `http://localhost:17493` by default.
-
-
- When Voicebox is running, visit the auto-generated API documentation at `http://localhost:17493/docs`
-
-
-## Base URL
-
-```
-http://localhost:17493
-```
-
-For remote deployments, replace `localhost` with your server's IP or hostname.
-
-## Authentication
-
-
- Currently, the API does not require authentication for local development. Authentication will be added in a future release for production deployments.
-
-
-## Quick Example
-
-Here's a simple example of generating speech:
-
-```bash
-# Generate speech
-curl -X POST http://localhost:17493/generate \
- -H "Content-Type: application/json" \
- -d '{
- "text": "Hello world",
- "profile_id": "abc123",
- "language": "en"
- }'
-```
-
-## API Endpoints
-
-The Voicebox API is organized into several categories:
-
-
-
- Create, list, update, and delete voice profiles
-
-
- Generate speech from text using voice profiles
-
-
- Record and transcribe audio
-
-
- Create and manage multi-voice stories (coming soon)
-
-
-
-## Core Endpoints
-
-### Voice Profiles
-
-```http
-GET /profiles # List all profiles
-POST /profiles # Create a new profile
-GET /profiles/{id} # Get profile details
-PUT /profiles/{id} # Update a profile
-DELETE /profiles/{id} # Delete a profile
-POST /profiles/{id}/samples # Add voice sample
-```
-
-### Generation
-
-```http
-POST /generate # Generate speech
-GET /history # List generation history
-GET /history/{id} # Get generation details
-DELETE /history/{id} # Delete from history
-```
-
-### Recordings
-
-```http
-POST /recordings # Start recording
-POST /recordings/stop # Stop recording
-POST /transcribe # Transcribe audio
-```
-
-## Response Format
-
-All API responses follow a consistent JSON format:
-
-```json
-{
- "success": true,
- "data": {
- // Response data
- },
- "error": null
-}
-```
-
-Error responses:
-
-```json
-{
- "success": false,
- "data": null,
- "error": {
- "message": "Error description",
- "code": "ERROR_CODE"
- }
-}
-```
-
-## Data Models
-
-### Voice Profile
-
-```json
-{
- "id": "abc123",
- "name": "John Smith",
- "language": "en",
- "description": "Professional narrator voice",
- "created_at": "2024-01-29T12:00:00Z",
- "samples": [
- {
- "id": "sample123",
- "audio_path": "/path/to/sample.wav",
- "duration": 15.5
- }
- ]
-}
-```
-
-### Generation
-
-```json
-{
- "id": "gen123",
- "text": "Hello world",
- "profile_id": "abc123",
- "language": "en",
- "audio_path": "/path/to/output.wav",
- "duration": 2.3,
- "created_at": "2024-01-29T12:00:00Z"
-}
-```
-
-## TypeScript Client
-
-Voicebox provides an auto-generated TypeScript client with full type safety:
-
-```typescript
-import { VoiceboxClient } from '@/lib/api'
-
-const client = new VoiceboxClient({
- baseUrl: 'http://localhost:17493'
-})
-
-// Create a profile
-const profile = await client.createProfile({
- name: 'John Smith',
- language: 'en'
-})
-
-// Generate speech
-const generation = await client.generate({
- text: 'Hello world',
- profile_id: profile.id,
- language: 'en'
-})
-```
-
-The client is automatically generated from the OpenAPI schema. See [Development Setup](/development/setup#generate-openapi-client) for details.
-
-## Rate Limiting
-
-
- Currently, there are no rate limits for local usage. Rate limiting will be added in a future release for production deployments.
-
-
-## WebSocket Support
-
-
- Real-time streaming generation via WebSockets is planned for a future release.
-
-
-## Use Cases
-
-
-
- Generate dynamic dialogue for NPCs and characters
-
-
- Automate voiceovers for videos and podcasts
-
-
- Build text-to-speech tools for visually impaired users
-
-
- Create custom voice interfaces
-
-
-
-## Next Steps
-
-
-
- Learn how to manage voice profiles
-
-
- Generate speech from text
-
-
diff --git a/docs/api/recordings.mdx b/docs/api/recordings.mdx
deleted file mode 100644
index dd0552d2..00000000
--- a/docs/api/recordings.mdx
+++ /dev/null
@@ -1,95 +0,0 @@
----
-title: "Recordings API"
-description: "Record and transcribe audio"
----
-
-## Start Recording
-
-```http
-POST /recordings/start
-```
-
-**Request:**
-```json
-{
- "source": "microphone"
-}
-```
-
-**Response:**
-```json
-{
- "recording_id": "rec123",
- "status": "recording"
-}
-```
-
-## Stop Recording
-
-```http
-POST /recordings/stop
-```
-
-**Request:**
-```json
-{
- "recording_id": "rec123"
-}
-```
-
-**Response:**
-```json
-{
- "recording_id": "rec123",
- "audio_url": "/audio/rec123.wav",
- "duration": 15.5
-}
-```
-
-## Transcribe Audio
-
-```http
-POST /transcribe
-```
-
-**Request:** (multipart/form-data)
-```
-audio:
-language: "en" (optional)
-```
-
-**Response:**
-```json
-{
- "text": "Transcribed speech text here",
- "language": "en",
- "duration": 15.5,
- "confidence": 0.95
-}
-```
-
-## TypeScript Example
-
-```typescript
-import { VoiceboxClient } from '@/lib/api'
-
-const client = new VoiceboxClient({
- baseUrl: 'http://localhost:17493'
-})
-
-// Start recording
-const recording = await client.startRecording({
- source: 'microphone'
-})
-
-// ... record audio ...
-
-// Stop recording
-const result = await client.stopRecording(recording.id)
-
-// Transcribe
-const transcription = await client.transcribe(audioFile, 'en')
-console.log(transcription.text)
-```
-
-For full API documentation, visit `http://localhost:17493/docs` when the server is running.
diff --git a/docs/api/voice-profiles.mdx b/docs/api/voice-profiles.mdx
deleted file mode 100644
index 3715e44c..00000000
--- a/docs/api/voice-profiles.mdx
+++ /dev/null
@@ -1,149 +0,0 @@
----
-title: "Voice Profiles API"
-description: "Manage voice profiles programmatically"
----
-
-## Endpoints
-
-### List Profiles
-
-```http
-GET /profiles
-```
-
-**Response:**
-```json
-{
- "profiles": [
- {
- "id": "abc123",
- "name": "John Smith",
- "language": "en",
- "description": "Professional narrator",
- "created_at": "2024-01-29T12:00:00Z",
- "sample_count": 2
- }
- ]
-}
-```
-
-### Get Profile
-
-```http
-GET /profiles/{id}
-```
-
-**Response:**
-```json
-{
- "id": "abc123",
- "name": "John Smith",
- "language": "en",
- "description": "Professional narrator",
- "created_at": "2024-01-29T12:00:00Z",
- "samples": [
- {
- "id": "sample123",
- "duration": 15.5,
- "created_at": "2024-01-29T12:00:00Z"
- }
- ]
-}
-```
-
-### Create Profile
-
-```http
-POST /profiles
-```
-
-**Request:**
-```json
-{
- "name": "John Smith",
- "language": "en",
- "description": "Professional narrator"
-}
-```
-
-**Response:**
-```json
-{
- "id": "abc123",
- "name": "John Smith",
- "language": "en",
- "description": "Professional narrator",
- "created_at": "2024-01-29T12:00:00Z"
-}
-```
-
-### Update Profile
-
-```http
-PUT /profiles/{id}
-```
-
-**Request:**
-```json
-{
- "name": "Updated Name",
- "description": "Updated description"
-}
-```
-
-### Delete Profile
-
-```http
-DELETE /profiles/{id}
-```
-
-**Response:**
-```json
-{
- "success": true
-}
-```
-
-### Add Voice Sample
-
-```http
-POST /profiles/{id}/samples
-```
-
-**Request:** (multipart/form-data)
-```
-audio:
-```
-
-**Response:**
-```json
-{
- "sample_id": "sample123",
- "duration": 15.5
-}
-```
-
-## TypeScript Example
-
-```typescript
-import { VoiceboxClient } from '@/lib/api'
-
-const client = new VoiceboxClient({
- baseUrl: 'http://localhost:17493'
-})
-
-// Create profile
-const profile = await client.createProfile({
- name: 'John Smith',
- language: 'en',
- description: 'Professional narrator'
-})
-
-// Add sample
-await client.addSample(profile.id, audioFile)
-
-// List all profiles
-const profiles = await client.listProfiles()
-```
-
-For full API documentation, visit `http://localhost:17493/docs` when the server is running.
diff --git a/docs/app/(home)/layout.tsx b/docs/app/(home)/layout.tsx
new file mode 100644
index 00000000..77379fac
--- /dev/null
+++ b/docs/app/(home)/layout.tsx
@@ -0,0 +1,6 @@
+import { HomeLayout } from 'fumadocs-ui/layouts/home';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default function Layout({ children }: LayoutProps<'/'>) {
+ return {children} ;
+}
diff --git a/docs/app/(home)/page.tsx b/docs/app/(home)/page.tsx
new file mode 100644
index 00000000..4393163a
--- /dev/null
+++ b/docs/app/(home)/page.tsx
@@ -0,0 +1,5 @@
+import { redirect } from 'next/navigation';
+
+export default function HomePage() {
+ redirect('/docs');
+}
diff --git a/docs/app/api/search/route.ts b/docs/app/api/search/route.ts
new file mode 100644
index 00000000..7ba7e823
--- /dev/null
+++ b/docs/app/api/search/route.ts
@@ -0,0 +1,7 @@
+import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+
+export const { GET } = createFromSource(source, {
+ // https://docs.orama.com/docs/orama-js/supported-languages
+ language: 'english',
+});
diff --git a/docs/app/docs/[[...slug]]/page.tsx b/docs/app/docs/[[...slug]]/page.tsx
new file mode 100644
index 00000000..35aca33e
--- /dev/null
+++ b/docs/app/docs/[[...slug]]/page.tsx
@@ -0,0 +1,74 @@
+import { createRelativeLink } from 'fumadocs-ui/mdx';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/page';
+import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+import { MarkdownCopyButton, ViewOptionsPopover } from '@/components/ai/page-actions';
+import { APIPage } from '@/components/api-page';
+import { getPageImage, source } from '@/lib/source';
+import { getMDXComponents } from '@/mdx-components';
+
+export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
+ const params = await props.params;
+ const page = source.getPage(params.slug);
+ if (!page) notFound();
+
+ const MDX = page.data.body;
+ const markdownUrl = `${page.url}.mdx`;
+ const githubUrl = `https://github.com/jamiepine/voicebox/blob/main/docs/content/docs/${page.path}`;
+
+ return (
+
+ {page.data.title}
+ {page.data.description}
+
+
+
+
+ );
+}
+
+export async function generateStaticParams() {
+ return source.generateParams();
+}
+
+export async function generateMetadata(props: PageProps<'/docs/[[...slug]]'>): Promise {
+ const params = await props.params;
+ const page = source.getPage(params.slug);
+ if (!page) notFound();
+
+ return {
+ title: page.data.title,
+ description: page.data.description,
+ openGraph: {
+ images: getPageImage(page).url,
+ },
+ };
+}
diff --git a/docs/app/docs/layout.tsx b/docs/app/docs/layout.tsx
new file mode 100644
index 00000000..299d2e28
--- /dev/null
+++ b/docs/app/docs/layout.tsx
@@ -0,0 +1,11 @@
+import { source } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default function Layout({ children }: LayoutProps<'/docs'>) {
+ return (
+
+ {children}
+
+ );
+}
diff --git a/docs/app/global.css b/docs/app/global.css
new file mode 100644
index 00000000..30af24fa
--- /dev/null
+++ b/docs/app/global.css
@@ -0,0 +1,14 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';
+@import 'fumadocs-openapi/css/preset.css';
+
+:root {
+ --color-fd-primary: hsl(43, 50%, 50%);
+ --color-fd-primary-foreground: hsl(222.2, 47.4%, 11.2%);
+}
+
+.dark {
+ --color-fd-primary: hsl(43, 50%, 45%);
+ --color-fd-primary-foreground: hsl(0, 0%, 95%);
+}
diff --git a/docs/app/layout.tsx b/docs/app/layout.tsx
new file mode 100644
index 00000000..22fdca31
--- /dev/null
+++ b/docs/app/layout.tsx
@@ -0,0 +1,17 @@
+import { RootProvider } from 'fumadocs-ui/provider/next';
+import './global.css';
+import { Inter } from 'next/font/google';
+
+const inter = Inter({
+ subsets: ['latin'],
+});
+
+export default function Layout({ children }: LayoutProps<'/'>) {
+ return (
+
+
+ {children}
+
+
+ );
+}
diff --git a/docs/app/llms-full.txt/route.ts b/docs/app/llms-full.txt/route.ts
new file mode 100644
index 00000000..d494d2cb
--- /dev/null
+++ b/docs/app/llms-full.txt/route.ts
@@ -0,0 +1,10 @@
+import { getLLMText, source } from '@/lib/source';
+
+export const revalidate = false;
+
+export async function GET() {
+ const scan = source.getPages().map(getLLMText);
+ const scanned = await Promise.all(scan);
+
+ return new Response(scanned.join('\n\n'));
+}
diff --git a/docs/app/llms.mdx/docs/[[...slug]]/route.ts b/docs/app/llms.mdx/docs/[[...slug]]/route.ts
new file mode 100644
index 00000000..ddc952b0
--- /dev/null
+++ b/docs/app/llms.mdx/docs/[[...slug]]/route.ts
@@ -0,0 +1,20 @@
+import { notFound } from 'next/navigation';
+import { getLLMText, source } from '@/lib/source';
+
+export const revalidate = false;
+
+export async function GET(_req: Request, { params }: RouteContext<'/llms.mdx/docs/[[...slug]]'>) {
+ const { slug } = await params;
+ const page = source.getPage(slug);
+ if (!page) notFound();
+
+ return new Response(await getLLMText(page), {
+ headers: {
+ 'Content-Type': 'text/markdown',
+ },
+ });
+}
+
+export function generateStaticParams() {
+ return source.generateParams();
+}
diff --git a/docs/app/og/docs/[...slug]/route.tsx b/docs/app/og/docs/[...slug]/route.tsx
new file mode 100644
index 00000000..f5df96db
--- /dev/null
+++ b/docs/app/og/docs/[...slug]/route.tsx
@@ -0,0 +1,36 @@
+import { getPageImage, source } from '@/lib/source';
+import { notFound } from 'next/navigation';
+import { ImageResponse } from 'next/og';
+import { generate as DefaultImage } from 'fumadocs-ui/og';
+
+export const revalidate = false;
+
+export async function GET(
+ _req: Request,
+ { params }: RouteContext<'/og/docs/[...slug]'>,
+) {
+ const { slug } = await params;
+ const page = source.getPage(slug.slice(0, -1));
+ if (!page) notFound();
+
+ return new ImageResponse(
+ (
+ >();
+
+export function MarkdownCopyButton({
+ markdownUrl,
+ ...props
+}: ComponentProps<'button'> & {
+ /**
+ * A URL to fetch the raw Markdown/MDX content of page
+ */
+ markdownUrl: string;
+}) {
+ const [isLoading, setLoading] = useState(false);
+ const [checked, onClick] = useCopyButton(async () => {
+ const cached = cache.get(markdownUrl);
+ if (cached) return navigator.clipboard.writeText(await cached);
+
+ setLoading(true);
+
+ try {
+ const promise = fetch(markdownUrl).then((res) => res.text());
+ cache.set(markdownUrl, promise);
+ await navigator.clipboard.write([
+ new ClipboardItem({
+ 'text/plain': promise,
+ }),
+ ]);
+ } finally {
+ setLoading(false);
+ }
+ });
+
+ return (
+
+ );
+}
+
+export function ViewOptionsPopover({
+ markdownUrl,
+ githubUrl,
+ ...props
+}: ComponentProps & {
+ /**
+ * A URL to the raw Markdown/MDX content of page
+ */
+ markdownUrl: string;
+
+ /**
+ * Source file URL on GitHub
+ */
+ githubUrl: string;
+}) {
+ const items = useMemo(() => {
+ const pageUrl = typeof window !== 'undefined' ? window.location.href : 'loading';
+ const q = `Read ${pageUrl}, I want to ask questions about it.`;
+
+ return [
+ {
+ title: 'Open in GitHub',
+ href: githubUrl,
+ icon: (
+
+ ),
+ },
+ {
+ title: 'View as Markdown',
+ href: markdownUrl,
+ icon:
+
+ Open
+
+
+ {items.map((item) => (
+
+ {item.icon}
+ {item.title}
+
+
+ );
+}
diff --git a/docs/components/api-page.client.tsx b/docs/components/api-page.client.tsx
new file mode 100644
index 00000000..afb84c75
--- /dev/null
+++ b/docs/components/api-page.client.tsx
@@ -0,0 +1,6 @@
+'use client';
+import { defineClientConfig } from 'fumadocs-openapi/ui/client';
+
+export default defineClientConfig({
+ // Client-side configuration for API playground
+});
diff --git a/docs/components/api-page.tsx b/docs/components/api-page.tsx
new file mode 100644
index 00000000..e52c79fd
--- /dev/null
+++ b/docs/components/api-page.tsx
@@ -0,0 +1,7 @@
+import { openapi } from '@/lib/openapi';
+import { createAPIPage } from 'fumadocs-openapi/ui';
+import client from './api-page.client';
+
+export const APIPage = createAPIPage(openapi, {
+ client,
+});
diff --git a/docs/components/ui/button.tsx b/docs/components/ui/button.tsx
new file mode 100644
index 00000000..7c504c7d
--- /dev/null
+++ b/docs/components/ui/button.tsx
@@ -0,0 +1,29 @@
+import { cva, type VariantProps } from 'class-variance-authority';
+
+const variants = {
+ primary:
+ 'bg-fd-primary text-fd-primary-foreground hover:bg-fd-primary/80 disabled:bg-fd-secondary disabled:text-fd-secondary-foreground',
+ outline: 'border hover:bg-fd-accent hover:text-fd-accent-foreground',
+ ghost: 'hover:bg-fd-accent hover:text-fd-accent-foreground',
+ secondary:
+ 'border bg-fd-secondary text-fd-secondary-foreground hover:bg-fd-accent hover:text-fd-accent-foreground',
+} as const;
+
+export const buttonVariants = cva(
+ 'inline-flex items-center justify-center rounded-md p-2 text-sm font-medium transition-colors duration-100 disabled:pointer-events-none disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring',
+ {
+ variants: {
+ variant: variants,
+ // fumadocs use `color` instead of `variant`
+ color: variants,
+ size: {
+ sm: 'gap-1 px-2 py-1.5 text-xs',
+ icon: 'p-1.5 [&_svg]:size-5',
+ 'icon-sm': 'p-1.5 [&_svg]:size-4.5',
+ 'icon-xs': 'p-1 [&_svg]:size-4',
+ },
+ },
+ },
+);
+
+export type ButtonProps = VariantProps;
diff --git a/docs/components/ui/popover.tsx b/docs/components/ui/popover.tsx
new file mode 100644
index 00000000..c00f4959
--- /dev/null
+++ b/docs/components/ui/popover.tsx
@@ -0,0 +1,32 @@
+'use client';
+import * as PopoverPrimitive from '@radix-ui/react-popover';
+import * as React from 'react';
+import { cn } from '../../lib/cn';
+
+const Popover = PopoverPrimitive.Root;
+
+const PopoverTrigger = PopoverPrimitive.Trigger;
+
+const PopoverContent = React.forwardRef<
+ React.ComponentRef,
+ React.ComponentPropsWithoutRef
+>(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (
+
+
+));
+PopoverContent.displayName = PopoverPrimitive.Content.displayName;
+
+const PopoverClose = PopoverPrimitive.PopoverClose;
+
+export { Popover, PopoverTrigger, PopoverContent, PopoverClose };
diff --git a/docs/content/docs/README.md b/docs/content/docs/README.md
new file mode 100644
index 00000000..66f7833d
--- /dev/null
+++ b/docs/content/docs/README.md
@@ -0,0 +1,67 @@
+---
+title: "Documentation README"
+description: "Voicebox documentation development guide"
+---
+
+This directory contains the documentation for Voicebox, built with [Fumadocs](https://fumadocs.dev).
+
+## Development
+
+### Prerequisites
+
+Install Mintlify globally using bun:
+
+```bash
+bun add -g mintlify
+```
+
+Or use the helper script:
+
+```bash
+bun run install:mintlify
+```
+
+### Running Locally
+
+```bash
+bun run dev
+```
+
+This will start the Mintlify dev server.
+
+The docs will be available at `http://localhost:3000`
+
+### Structure
+
+```
+docs/
+├── mint.json # Mintlify configuration
+├── custom.css # Custom styles
+├── overview/ # Getting started & feature docs
+├── guides/ # User guides
+├── api/ # API reference
+├── development/ # Developer documentation
+├── logo/ # Logo assets
+└── public/ # Static assets
+```
+
+### Writing Docs
+
+- Use `.mdx` files for all documentation pages
+- Follow the existing structure in `mint.json` for navigation
+- Use Mintlify components for enhanced formatting (Card, CardGroup, Accordion, etc.)
+- Reference the [Mintlify documentation](https://mintlify.com/docs) for available components
+
+## Deployment
+
+Docs are automatically deployed when changes are pushed to the main branch.
+
+To manually deploy:
+
+```bash
+mintlify deploy
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines.
diff --git a/docs/TROUBLESHOOTING.md b/docs/content/docs/TROUBLESHOOTING.md
similarity index 98%
rename from docs/TROUBLESHOOTING.md
rename to docs/content/docs/TROUBLESHOOTING.md
index 78749f96..d74d0bf7 100644
--- a/docs/TROUBLESHOOTING.md
+++ b/docs/content/docs/TROUBLESHOOTING.md
@@ -1,4 +1,7 @@
-# Troubleshooting Guide
+---
+title: "Troubleshooting Guide"
+description: "Common issues and solutions for Voicebox"
+---
Common issues and solutions for Voicebox.
diff --git a/docs/content/docs/api-reference/meta.json b/docs/content/docs/api-reference/meta.json
new file mode 100644
index 00000000..78943f50
--- /dev/null
+++ b/docs/content/docs/api-reference/meta.json
@@ -0,0 +1,5 @@
+{
+ "title": "API Reference",
+ "defaultOpen": true,
+ "pages": ["unknown"]
+}
diff --git a/docs/content/docs/api-reference/unknown/add_profile_sample_profiles__profile_id__samples_post.mdx b/docs/content/docs/api-reference/unknown/add_profile_sample_profiles__profile_id__samples_post.mdx
new file mode 100644
index 00000000..976dd731
--- /dev/null
+++ b/docs/content/docs/api-reference/unknown/add_profile_sample_profiles__profile_id__samples_post.mdx
@@ -0,0 +1,16 @@
+---
+title: Add Profile Sample
+description: Add a sample to a voice profile.
+full: true
+_openapi:
+ method: POST
+ toc: []
+ structuredData:
+ headings: []
+ contents:
+ - content: Add a sample to a voice profile.
+---
+
+{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}
+
+
+
+
+
+
+
+
+
### State Management
@@ -64,16 +67,69 @@ const useProfileStore = create((set) => ({
### API Structure
-```python
-# main.py - API routes
-@app.post("/generate")
-async def generate_speech(request: GenerateRequest):
- # 1. Validate request
- # 2. Load voice profile
- # 3. Generate audio with TTS
- # 4. Save to database
- # 5. Return response
-```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+### Request Flow
+
+HTTP request → **routes/** (validate input, parse params) → **services/** (business logic, orchestration) → **backends/** (TTS/STT inference) → **utils/** (audio processing)
+
+Route handlers are intentionally thin. They validate input, delegate to a service function, and format the response. All business logic lives in `services/`.
+
+### Key Modules
+
+- **app.py** — FastAPI app factory, CORS, lifecycle events
+- **main.py** — Entry point (imports app, runs uvicorn)
+- **server.py** — Tauri sidecar launcher, parent-pid watchdog
+- **services/generation.py** — Single function handling all generation modes (generate, retry, regenerate)
+- **services/task_queue.py** — Serial generation queue for GPU inference
+- **backends/__init__.py** — Protocol definitions and backend factory
+- **backends/base.py** — Shared utilities across all engine implementations
+
+### Backend Selection
+
+The server detects the best inference backend at startup:
+
+| Platform | Backend | Acceleration |
+|----------|---------|-------------|
+| macOS (Apple Silicon) | MLX | Metal / Neural Engine |
+| Windows / Linux (NVIDIA) | PyTorch | CUDA |
+| Linux (AMD) | PyTorch | ROCm |
+| Intel Arc | PyTorch | IPEX / XPU |
+| Windows (any GPU) | PyTorch | DirectML |
+| Any | PyTorch | CPU fallback |
### Data Model
@@ -89,11 +145,13 @@ The database uses three main tables:
### Rust Backend
-```rust
-// Sidecar process management
-// File system access
-// Native integrations
-```
+
+
+
+
### Responsibilities
@@ -196,11 +254,11 @@ When a user generates speech, the data flows through the following stages:
## Next Steps
-
-
+
+
Set up your dev environment
-
+
Contribute to Voicebox
-
+
+
+
+ {children}
;
+}
+
+function Accordion({ title, children }: { title: string; children: ReactNode }) {
+ return (
+
+
+ );
+}
+
+export function getMDXComponents(components?: MDXComponents): MDXComponents {
+ return {
+ ...defaultMdxComponents,
+ // Layout components
+ Card,
+ Cards,
+ // Files
+ Files,
+ Folder,
+ File,
+ // Callouts
+ Callout,
+ // Tabs
+ Tabs,
+ Tab,
+ // Steps
+ Steps,
+ Step,
+ // Accordion (native HTML-based)
+ AccordionGroup,
+ Accordion,
+ // OpenAPI component
+ APIPage,
+ ...components,
+ };
+}
diff --git a/docs/mint.json b/docs/mint.json
deleted file mode 100644
index c4f582ea..00000000
--- a/docs/mint.json
+++ /dev/null
@@ -1,102 +0,0 @@
-{
- "$schema": "https://mintlify.com/schema.json",
- "name": "Voicebox",
- "logo": {
- "light": "/logo/icon-light.png",
- "dark": "/logo/icon-dark.png"
- },
- "favicon": "/favicon.png",
- "colors": {
- "primary": "#BF9E40",
- "light": "#D4B560",
- "dark": "#A68A35"
- },
- "styles": {
- "css": ["/custom.css"]
- },
- "anchors": [
- {
- "name": "Overview",
- "icon": "book-open",
- "url": "overview"
- },
- {
- "name": "API",
- "icon": "code",
- "url": "api"
- },
- {
- "name": "Developer",
- "icon": "book-open-cover",
- "url": "developer"
- },
- {
- "name": "GitHub",
- "icon": "github",
- "url": "https://github.com/jamiepine/voicebox"
- }
- ],
- "navigation": [
- {
- "group": "Getting Started",
- "icon": "rocket",
- "pages": ["overview/introduction", "overview/installation", "overview/quick-start"]
- },
- {
- "group": "Features",
- "icon": "sparkles",
- "pages": [
- "overview/voice-cloning",
- "overview/stories-editor",
- "overview/recording-transcription",
- "overview/generation-history",
- "overview/remote-mode"
- ]
- },
- {
- "group": "User Guides",
- "icon": "compass",
- "pages": [
- "overview/creating-voice-profiles",
- "overview/generating-speech",
- "overview/building-stories",
- "overview/troubleshooting"
- ]
- },
- {
- "group": "Development",
- "icon": "wrench",
- "pages": [
- "developer/setup",
- "developer/architecture",
- "developer/contributing",
- "developer/building",
- "developer/autoupdater"
- ]
- },
- {
- "group": "API Reference",
- "icon": "code",
- "pages": [
- "api/overview",
- "api/authentication",
- "api/voice-profiles",
- "api/generation",
- "api/recordings"
- ]
- },
- {
- "group": "Architecture",
- "icon": "book-open-cover",
- "pages": [
- "developer/voice-profiles",
- "developer/tts-generation",
- "developer/history",
- "developer/stories",
- "developer/transcription",
- "developer/audio-channels",
- "developer/model-management"
- ]
- }
- ]
-}
diff --git a/docs/next.config.mjs b/docs/next.config.mjs
new file mode 100644
index 00000000..dd4ad8b4
--- /dev/null
+++ b/docs/next.config.mjs
@@ -0,0 +1,25 @@
+import { createMDX } from 'fumadocs-mdx/next';
+
+const withMDX = createMDX();
+
+/** @type {import('next').NextConfig} */
+const config = {
+ reactStrictMode: true,
+ async rewrites() {
+ return [
+ {
+ source: '/docs/:path*.mdx',
+ destination: '/llms.mdx/docs/:path*',
+ },
+ ];
+ },
+ webpack: (config) => {
+ config.experiments = {
+ ...config.experiments,
+ topLevelAwait: true,
+ };
+ return config;
+ },
+};
+
+export default withMDX(config);
diff --git a/docs/nixpacks.toml b/docs/nixpacks.toml
deleted file mode 100644
index 5cb001d9..00000000
--- a/docs/nixpacks.toml
+++ /dev/null
@@ -1,11 +0,0 @@
-[phases.setup]
-nixPkgs = ["nodejs_20", "bun"]
-
-[phases.install]
-cmds = ["bun install"]
-
-[phases.build]
-cmds = ["bun run build"]
-
-[start]
-cmd = "bun run start"
diff --git a/docs/openapi.json b/docs/openapi.json
new file mode 100644
index 00000000..1a196e6c
--- /dev/null
+++ b/docs/openapi.json
@@ -0,0 +1 @@
+{"openapi":"3.1.0","info":{"title":"voicebox API","description":"Production-quality Qwen3-TTS voice cloning API","version":"0.1.0"},"servers":[{"url":"http://localhost:8000","description":"Local development server"}],"paths":{"/":{"get":{"summary":"Root","description":"Root endpoint.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","description":"Health check endpoint.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/profiles":{"get":{"summary":"List Profiles","description":"List all voice profiles.","operationId":"list_profiles_profiles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/VoiceProfileResponse"},"type":"array","title":"Response List Profiles Profiles Get"}}}}}},"post":{"summary":"Create Profile","description":"Create a new voice profile.","operationId":"create_profile_profiles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceProfileCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/profiles/{profile_id}":{"get":{"summary":"Get Profile","description":"Get a voice profile by ID.","operationId":"get_profile_profiles__profile_id__get","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"summary":"Update Profile","description":"Update a voice profile.","operationId":"update_profile_profiles__profile_id__put","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceProfileCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Profile","description":"Delete a voice profile.","operationId":"delete_profile_profiles__profile_id__delete","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/profiles/{profile_id}/samples":{"post":{"summary":"Add Profile Sample","description":"Add a sample to a voice profile.","operationId":"add_profile_sample_profiles__profile_id__samples_post","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_add_profile_sample_profiles__profile_id__samples_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileSampleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Get Profile Samples","description":"Get all samples for a profile.","operationId":"get_profile_samples_profiles__profile_id__samples_get","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProfileSampleResponse"},"title":"Response Get Profile Samples Profiles Profile Id Samples Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/profiles/samples/{sample_id}":{"delete":{"summary":"Delete Profile Sample","description":"Delete a profile sample.","operationId":"delete_profile_sample_profiles_samples__sample_id__delete","parameters":[{"name":"sample_id","in":"path","required":true,"schema":{"type":"string","title":"Sample Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate":{"post":{"summary":"Generate Speech","description":"Generate speech from text using a voice profile.","operationId":"generate_speech_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/history":{"get":{"summary":"List History","description":"List generation history with optional filters.","operationId":"list_history_history_get","parameters":[{"name":"profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Id"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/history/{generation_id}":{"get":{"summary":"Get Generation","description":"Get a generation by ID.","operationId":"get_generation_history__generation_id__get","parameters":[{"name":"generation_id","in":"path","required":true,"schema":{"type":"string","title":"Generation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Generation","description":"Delete a generation.","operationId":"delete_generation_history__generation_id__delete","parameters":[{"name":"generation_id","in":"path","required":true,"schema":{"type":"string","title":"Generation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/history/stats":{"get":{"summary":"Get Stats","description":"Get generation statistics.","operationId":"get_stats_history_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/transcribe":{"post":{"summary":"Transcribe Audio","description":"Transcribe audio file to text.","operationId":"transcribe_audio_transcribe_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_transcribe_audio_transcribe_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/audio/{generation_id}":{"get":{"summary":"Get Audio","description":"Serve generated audio file.","operationId":"get_audio_audio__generation_id__get","parameters":[{"name":"generation_id","in":"path","required":true,"schema":{"type":"string","title":"Generation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/models/load":{"post":{"summary":"Load Model","description":"Manually load TTS model.","operationId":"load_model_models_load_post","parameters":[{"name":"model_size","in":"query","required":false,"schema":{"type":"string","default":"1.7B","title":"Model Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/models/unload":{"post":{"summary":"Unload Model","description":"Unload TTS model to free memory.","operationId":"unload_model_models_unload_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/models/progress/{model_name}":{"get":{"summary":"Get Model Progress","description":"Get model download progress via Server-Sent Events.","operationId":"get_model_progress_models_progress__model_name__get","parameters":[{"name":"model_name","in":"path","required":true,"schema":{"type":"string","title":"Model Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/models/status":{"get":{"summary":"Get Model Status","description":"Get status of all available models.","operationId":"get_model_status_models_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelStatusListResponse"}}}}}}},"/models/download":{"post":{"summary":"Trigger Model Download","description":"Trigger download of a specific model.","operationId":"trigger_model_download_models_download_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelDownloadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_add_profile_sample_profiles__profile_id__samples_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"reference_text":{"type":"string","title":"Reference Text"}},"type":"object","required":["file","reference_text"],"title":"Body_add_profile_sample_profiles__profile_id__samples_post"},"Body_transcribe_audio_transcribe_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},"type":"object","required":["file"],"title":"Body_transcribe_audio_transcribe_post"},"GenerationRequest":{"properties":{"profile_id":{"type":"string","title":"Profile Id"},"text":{"type":"string","maxLength":5000,"minLength":1,"title":"Text"},"language":{"type":"string","pattern":"^(en|zh)$","title":"Language","default":"en"},"seed":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Seed"},"model_size":{"anyOf":[{"type":"string","pattern":"^(1\\.7B|0\\.6B)$"},{"type":"null"}],"title":"Model Size","default":"1.7B"}},"type":"object","required":["profile_id","text"],"title":"GenerationRequest","description":"Request model for voice generation."},"GenerationResponse":{"properties":{"id":{"type":"string","title":"Id"},"profile_id":{"type":"string","title":"Profile Id"},"text":{"type":"string","title":"Text"},"language":{"type":"string","title":"Language"},"audio_path":{"type":"string","title":"Audio Path"},"duration":{"type":"number","title":"Duration"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","profile_id","text","language","audio_path","duration","seed","created_at"],"title":"GenerationResponse","description":"Response model for voice generation."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"model_loaded":{"type":"boolean","title":"Model Loaded"},"model_downloaded":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Downloaded"},"model_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Size"},"gpu_available":{"type":"boolean","title":"Gpu Available"},"vram_used_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vram Used Mb"}},"type":"object","required":["status","model_loaded","gpu_available"],"title":"HealthResponse","description":"Response model for health check."},"HistoryListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/HistoryResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"HistoryListResponse","description":"Response model for history list."},"HistoryResponse":{"properties":{"id":{"type":"string","title":"Id"},"profile_id":{"type":"string","title":"Profile Id"},"profile_name":{"type":"string","title":"Profile Name"},"text":{"type":"string","title":"Text"},"language":{"type":"string","title":"Language"},"audio_path":{"type":"string","title":"Audio Path"},"duration":{"type":"number","title":"Duration"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","profile_id","profile_name","text","language","audio_path","duration","seed","created_at"],"title":"HistoryResponse","description":"Response model for history entry (includes profile name)."},"ModelDownloadRequest":{"properties":{"model_name":{"type":"string","title":"Model Name"}},"type":"object","required":["model_name"],"title":"ModelDownloadRequest","description":"Request model for triggering model download."},"ModelStatus":{"properties":{"model_name":{"type":"string","title":"Model Name"},"display_name":{"type":"string","title":"Display Name"},"downloaded":{"type":"boolean","title":"Downloaded"},"size_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Size Mb"},"loaded":{"type":"boolean","title":"Loaded","default":false}},"type":"object","required":["model_name","display_name","downloaded"],"title":"ModelStatus","description":"Response model for model status."},"ModelStatusListResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/ModelStatus"},"type":"array","title":"Models"}},"type":"object","required":["models"],"title":"ModelStatusListResponse","description":"Response model for model status list."},"ProfileSampleResponse":{"properties":{"id":{"type":"string","title":"Id"},"profile_id":{"type":"string","title":"Profile Id"},"audio_path":{"type":"string","title":"Audio Path"},"reference_text":{"type":"string","title":"Reference Text"}},"type":"object","required":["id","profile_id","audio_path","reference_text"],"title":"ProfileSampleResponse","description":"Response model for profile sample."},"TranscriptionResponse":{"properties":{"text":{"type":"string","title":"Text"},"duration":{"type":"number","title":"Duration"}},"type":"object","required":["text","duration"],"title":"TranscriptionResponse","description":"Response model for transcription."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VoiceProfileCreate":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description"},"language":{"type":"string","pattern":"^(en|zh)$","title":"Language","default":"en"}},"type":"object","required":["name"],"title":"VoiceProfileCreate","description":"Request model for creating a voice profile."},"VoiceProfileResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"language":{"type":"string","title":"Language"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","language","created_at","updated_at"],"title":"VoiceProfileResponse","description":"Response model for voice profile."}}}}
\ No newline at end of file
diff --git a/docs/overview/introduction.mdx b/docs/overview/introduction.mdx
deleted file mode 100644
index 21edd4fc..00000000
--- a/docs/overview/introduction.mdx
+++ /dev/null
@@ -1,58 +0,0 @@
----
-title: "Introduction"
-description: "Welcome to Voicebox - the open-source voice synthesis studio"
----
-
-## What is Voicebox?
-
-Voicebox is a **local-first voice cloning studio** with DAW-like features for professional voice synthesis. Think of it as a **local, free and open-source alternative to ElevenLabs** — download models, clone voices, and generate speech entirely on your machine.
-
-
- + ▶ + {title} +
+{children}
+ 
-
-
-Unlike cloud services that lock your voice data behind subscriptions, Voicebox gives you:
-
-- **Complete privacy** — models and voice data stay on your machine
-- **Professional tools** — multi-track timeline editor, audio trimming, conversation mixing
-- **Model flexibility** — currently powered by Qwen3-TTS, with support for XTTS, Bark, and other models coming soon
-- **API-first** — use the desktop app or integrate voice synthesis into your own projects
-- **Native performance** — built with Tauri (Rust), not Electron
-
-Download a voice model, clone any voice from a few seconds of audio, and compose multi-voice projects with studio-grade editing tools. No Python install required, no cloud dependency, no limits.
-
-## Key Features
-
-