# ahmetsukkar/voxaistudio architecture

> Architecture diagram of the GitHub repository ahmetsukkar/voxaistudio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmetsukkar/voxaistudio
- Repository: https://github.com/ahmetsukkar/voxaistudio

## Overview

Vox AI Studio is a credits-based AI voice-generation SaaS. Users authenticate, configure text-to-speech or dialogue, generate and store audio, then manage projects and credits; purchases replenish credits through Polar. The graph retains documented authentication, billing, voice uploads, analytics, admin email, and blog capabilities. Relationship evidence is limited to README statements and the sampled/indexed files; dashed links mark documented but unsampled integrations or flows.

Main entry points: [`src/actions/tts.ts`](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/tts.ts) (Generation actions), [`src/lib/auth.ts`](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/auth.ts) (Auth and Polar), [`src/server/db.ts`](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/server/db.ts) (Application database), [`src/app/(dashboard)/dashboard/studio/page.tsx`](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(dashboard)/dashboard/studio/page.tsx) (Studio dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_dashboard["Studio dashboard<br/>[page.tsx]"]
  node_ttsui["TTS studio<br/>[tts-studio.tsx]"]
  node_dialogueui["Dialogue studio"]
  node_projects["Audio projects<br/>[page.tsx]"]
  node_publicsite["Public site<br/>[page.tsx]"]
  node_blog["Blog<br/>[page.tsx]"]
end

subgraph group_generation["Speech generation"]
  node_ttsaction["Generation actions<br/>[tts.ts]"]
  node_dialogue["Dialogue synthesis<br/>[dialogue.ts]"]
  node_provider["Gemini TTS provider<br/>[gemini-provider.ts]"]
  node_ttsoptions["Voice and language options<br/>[GeminiOptions.ts]"]
  node_audio["Audio playback<br/>[audio-manager.ts]"]
  node_voiceupload["Voice uploads<br/>[voice-upload.ts]"]
  node_storage["R2 voice storage"]
end

subgraph group_identity["Identity and billing"]
  node_authui["Sign-in and sign-up<br/>[sign-in-client.tsx]"]
  node_authclient["Auth client<br/>[auth-client.ts]"]
  node_auth["Auth and Polar<br/>[auth.ts]"]
  node_credits["Credit selection<br/>[select-key.ts]"]
  node_plans["Plans and credits<br/>[plans.ts]"]
end

subgraph group_operations["Platform services"]
  node_db[("Application database<br/>[db.ts]")]
  node_analytics["Analytics<br/>[log-event.ts]"]
  node_email["Email delivery<br/>[send-email.ts]"]
  node_adminemail["Admin email API<br/>[route.ts]"]
  node_blogadmin["Blog authoring<br/>[CreateBlogForm.tsx]"]
end

node_user(("Studio user"))
node_gemini{{"Google Gemini"}}
node_objectstore[("Object storage")]
node_polar{{"Polar payments"}}

node_user -.->|"opens"| node_dashboard
node_dashboard -.->|"offers"| node_ttsui
node_dashboard -.->|"offers"| node_dialogueui
node_ttsui -.->|"requests"| node_ttsaction
node_dialogueui -.->|"requests"| node_ttsaction
node_ttsaction -->|"delegates"| node_dialogue
node_ttsaction -->|"generates"| node_provider
node_ttsaction -->|"reserves"| node_credits
node_ttsaction -->|"logs"| node_analytics
node_ttsaction -->|"manages projects"| node_db
node_provider -.->|"synthesizes speech"| node_gemini
node_ttsaction -.->|"stores audio"| node_objectstore
node_projects -->|"manages projects"| node_ttsaction
node_ttsui -.->|"configures voices"| node_ttsoptions
node_user -.->|"signs in"| node_authui
node_authui -->|"authenticates"| node_authclient
node_authclient -.->|"calls"| node_auth
node_auth -->|"persists accounts"| node_db
node_auth -->|"sends verification"| node_email
node_auth -->|"configures billing"| node_polar
node_auth -->|"adds purchase credits"| node_db
node_auth -->|"maps purchase credits"| node_plans
node_credits -.->|"reads balances"| node_db
node_user -.->|"uploads voice"| node_voiceupload
node_voiceupload -.->|"selects provider"| node_storage
node_storage -->|"records voice"| node_db
node_storage -->|"uploads files"| node_objectstore
node_user -.->|"reviews history"| node_projects
node_user -.->|"visits"| node_publicsite
node_publicsite -.->|"browses"| node_blog
node_blogadmin -.->|"publishes content"| node_blog
node_adminemail -->|"sends email"| node_email
node_user -.->|"plays audio"| node_audio

click node_dashboard "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(dashboard)/dashboard/studio/page.tsx"
click node_ttsui "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/components/studio/tts/tts-studio.tsx"
click node_dialogueui "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/components/studio/dialogue/dialogue-studio.tsx"
click node_projects "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(dashboard)/dashboard/projects/page.tsx"
click node_publicsite "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(public)/page.tsx"
click node_blog "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(public)/blog/page.tsx"
click node_ttsaction "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/tts.ts"
click node_dialogue "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/tts/dialogue.ts"
click node_provider "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/tts/providers/gemini-provider.ts"
click node_ttsoptions "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/data/GeminiOptions.ts"
click node_audio "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/audio/audio-manager.ts"
click node_voiceupload "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/voice-upload.ts"
click node_storage "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/voice-upload/storage/r2-storage-provider.ts"
click node_authui "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(auth)/auth/sign-in/sign-in-client.tsx"
click node_authclient "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/auth-client.ts"
click node_auth "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/auth.ts"
click node_credits "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/credits/select-key.ts"
click node_plans "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/config/plans.ts"
click node_db "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/server/db.ts"
click node_analytics "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/analytics/log-event.ts"
click node_email "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/email/send-email.ts"
click node_adminemail "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/api/admin/send-email/route.ts"
click node_blogadmin "https://github.com/ahmetsukkar/voxaistudio/blob/main/src/components/blog/CreateBlogForm.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_ttsui,node_dialogueui,node_projects,node_publicsite,node_blog,node_user toneBlue
class node_ttsaction,node_dialogue,node_provider,node_ttsoptions,node_audio,node_voiceupload,node_storage,node_objectstore toneAmber
class node_authui,node_authclient,node_auth,node_credits,node_plans toneMint
class node_db,node_analytics,node_email,node_adminemail,node_blogadmin toneRose
class node_gemini,node_polar toneIndigo
```

## Components

### User experience

- [Studio dashboard](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(dashboard)/dashboard/studio/page.tsx): `src/app/(dashboard)/dashboard/studio/page.tsx`
- [TTS studio](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/components/studio/tts/tts-studio.tsx): `src/components/studio/tts/tts-studio.tsx`
- [Dialogue studio](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/components/studio/dialogue/dialogue-studio.tsx): `src/components/studio/dialogue/dialogue-studio.tsx`
- [Audio projects](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(dashboard)/dashboard/projects/page.tsx): `src/app/(dashboard)/dashboard/projects/page.tsx`
- [Public site](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(public)/page.tsx): `src/app/(public)/page.tsx`
- [Blog](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(public)/blog/page.tsx): `src/app/(public)/blog/page.tsx`

### Speech generation

- [Generation actions](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/tts.ts): `src/actions/tts.ts`
- [Dialogue synthesis](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/tts/dialogue.ts): `src/actions/tts/dialogue.ts`
- [Gemini TTS provider](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/tts/providers/gemini-provider.ts): `src/actions/tts/providers/gemini-provider.ts`
- [Voice and language options](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/data/GeminiOptions.ts): `src/data/GeminiOptions.ts`
- [Audio playback](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/audio/audio-manager.ts): `src/lib/audio/audio-manager.ts`
- [Voice uploads](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/voice-upload.ts): `src/actions/voice-upload.ts`
- [R2 voice storage](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/actions/voice-upload/storage/r2-storage-provider.ts): `src/actions/voice-upload/storage/r2-storage-provider.ts`

### Identity and billing

- [Sign-in and sign-up](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/(auth)/auth/sign-in/sign-in-client.tsx): `src/app/(auth)/auth/sign-in/sign-in-client.tsx`
- [Auth client](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/auth-client.ts): `src/lib/auth-client.ts`
- [Auth and Polar](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Credit selection](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/credits/select-key.ts): `src/lib/credits/select-key.ts`
- [Plans and credits](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/config/plans.ts): `src/config/plans.ts`

### Platform services

- [Application database](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/server/db.ts): `src/server/db.ts`
- [Analytics](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/analytics/log-event.ts): `src/lib/analytics/log-event.ts`
- [Email delivery](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/lib/email/send-email.ts): `src/lib/email/send-email.ts`
- [Admin email API](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/app/api/admin/send-email/route.ts): `src/app/api/admin/send-email/route.ts`
- [Blog authoring](https://github.com/ahmetsukkar/voxaistudio/blob/main/src/components/blog/CreateBlogForm.tsx): `src/components/blog/CreateBlogForm.tsx`

### Other components

- **Studio user**
- **Google Gemini**
- **Object storage**
- **Polar payments**

## Connections

- Studio user → Studio dashboard: opens
- Studio dashboard → TTS studio: offers
- Studio dashboard → Dialogue studio: offers
- TTS studio → Generation actions: requests
- Dialogue studio → Generation actions: requests
- Generation actions → Dialogue synthesis: delegates (evidence: `src/actions/tts.ts`)
- Generation actions → Gemini TTS provider: generates (evidence: `src/actions/tts.ts`)
- Generation actions → Credit selection: reserves (evidence: `src/actions/tts.ts`)
- Generation actions → Analytics: logs (evidence: `src/actions/tts.ts`)
- Generation actions → Application database: manages projects (evidence: `src/actions/tts.ts`)
- Gemini TTS provider → Google Gemini: synthesizes speech
- Generation actions → Object storage: stores audio
- Audio projects → Generation actions: manages projects (evidence: `src/app/(dashboard)/dashboard/projects/page.tsx`)
- TTS studio → Voice and language options: configures voices
- Studio user → Sign-in and sign-up: signs in
- Sign-in and sign-up → Auth client: authenticates (evidence: `src/app/(auth)/auth/sign-in/sign-in-client.tsx`)
- Auth client → Auth and Polar: calls
- Auth and Polar → Application database: persists accounts (evidence: `src/lib/auth.ts`)
- Auth and Polar → Email delivery: sends verification (evidence: `src/lib/auth.ts`)
- Auth and Polar → Polar payments: configures billing (evidence: `src/lib/auth.ts`)
- Auth and Polar → Application database: adds purchase credits (evidence: `src/lib/auth.ts`)
- Auth and Polar → Plans and credits: maps purchase credits (evidence: `src/lib/auth.ts`)
- Credit selection → Application database: reads balances (evidence: `src/actions/tts.ts`)
- Studio user → Voice uploads: uploads voice
- Voice uploads → R2 voice storage: selects provider
- R2 voice storage → Application database: records voice (evidence: `src/actions/voice-upload/storage/r2-storage-provider.ts`)
- R2 voice storage → Object storage: uploads files (evidence: `src/actions/voice-upload/storage/r2-storage-provider.ts`)
- Studio user → Audio projects: reviews history
- Studio user → Public site: visits
- Public site → Blog: browses
- Blog authoring → Blog: publishes content
- Admin email API → Email delivery: sends email (evidence: `src/app/api/admin/send-email/route.ts`)
- Studio user → Audio playback: plays audio
