# nipponjo/tts-arabic-flutter architecture

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

- Interactive diagram: https://gitdiagram.com/nipponjo/tts-arabic-flutter
- Repository: https://github.com/nipponjo/tts-arabic-flutter

## Overview

This is a small Flutter demo for Arabic text-to-speech. The documented user workflow is to provide ONNX model assets and use the app to run Arabic TTS; the README identifies text-to-mel models, a vocoder, and an optional vowelizer. Dart implementation files are present in the tree but were not excerpted, so internal call relationships are not asserted. The model-stage links are documented capabilities, not verified call order.

Main entry points: [`lib/main.dart`](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/main.dart) (App entry), [`lib/tts/model.dart`](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/model.dart) (Text-to-mel model), [`lib/vowelizer/shakkelha/model.dart`](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/vowelizer/shakkelha/model.dart) (Vowelizer), [`lib/tts/audio.dart`](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/audio.dart) (Audio handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter app"]
  node_ui["App entry<br/>[main.dart]"]
end

subgraph group_text["Arabic text processing"]
  node_vowelizer["Vowelizer<br/>[model.dart]"]
  node_tokenizer["Arabic tokenizer<br/>[ar_tokenizer.dart]"]
  node_phonemizer["Arabic phonemizer<br/>[ar_phonemizer.dart]"]
end

subgraph group_speech["Speech generation"]
  node_ttsmodel["Text-to-mel model<br/>[model.dart]"]
  node_vocoder["Vocoder<br/>[model.dart]"]
  node_audio["Audio handling<br/>[audio.dart]"]
  node_onnx["ONNX runtime"]
end

node_user(("App user"))

node_user -->|"uses"| node_ui
node_ui -->|"runs models"| node_onnx
node_ui -.->|"optional vowelization"| node_vowelizer
node_ui -->|"selects model"| node_ttsmodel
node_ui -->|"selects vocoder"| node_vocoder
node_ttsmodel -.->|"produces speech audio"| node_audio

click node_ui "https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/main.dart"
click node_vowelizer "https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/vowelizer/shakkelha/model.dart"
click node_tokenizer "https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/ar_tokenizer.dart"
click node_phonemizer "https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/ar_phonemizer.dart"
click node_ttsmodel "https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/model.dart"
click node_vocoder "https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/model.dart"
click node_audio "https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/audio.dart"

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_ui,node_user toneBlue
class node_vowelizer,node_tokenizer,node_phonemizer toneAmber
class node_ttsmodel,node_vocoder,node_audio,node_onnx toneMint
```

## Components

### Flutter app

- [App entry](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/main.dart): `lib/main.dart`

### Arabic text processing

- [Vowelizer](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/vowelizer/shakkelha/model.dart): `lib/vowelizer/shakkelha/model.dart`
- [Arabic tokenizer](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/ar_tokenizer.dart): `lib/tts/ar_tokenizer.dart`
- [Arabic phonemizer](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/ar_phonemizer.dart): `lib/tts/ar_phonemizer.dart`

### Speech generation

- [Text-to-mel model](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/model.dart): `lib/tts/model.dart`
- [Vocoder](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/model.dart): `lib/tts/model.dart`
- [Audio handling](https://github.com/nipponjo/tts-arabic-flutter/blob/main/lib/tts/audio.dart): `lib/tts/audio.dart`
- **ONNX runtime**

### Other components

- **App user**

## Connections

- App user → App entry: uses (evidence: `README.md`)
- App entry → ONNX runtime: runs models (evidence: `README.md`)
- App entry → Vowelizer: optional vowelization (evidence: `README.md`)
- App entry → Text-to-mel model: selects model (evidence: `README.md`)
- App entry → Vocoder: selects vocoder (evidence: `README.md`)
- Text-to-mel model → Audio handling: produces speech audio
