# aazmii/translator architecture

> Architecture diagram of the GitHub repository aazmii/translator, 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/aazmii/translator
- Repository: https://github.com/aazmii/translator

## Overview

Go Translator is a Flutter app for translating text with on-device ML Kit models. Its principal workflow is entering text and receiving a translation; separate capabilities manage offline language models, bookmarks, speech input, text-to-speech, and local settings. The tree shows feature-first presentation, domain, and data layers, but the supplied source excerpts contain no application code. Accordingly, edges beyond the README’s documented capabilities are dashed and unverified rather than inferred as confirmed calls.

Main entry points: [`lib/src/modules/home/presentation/home.view/home.view.dart`](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/presentation/home.view/home.view.dart) (Translator screen), [`lib/src/app.dart`](https://github.com/aazmii/translator/blob/main/lib/src/app.dart) (App shell), [`lib/src/modules/home/domain/usecases/translate_text.dart`](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/domain/usecases/translate_text.dart) (Translate text), [`lib/src/modules/home/data/repository/translation.repo.impl.dart`](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/data/repository/translation.repo.impl.dart) (Translation repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app_shell["App shell<br/>[app.dart]"]
  node_router["Route setup<br/>[router.dart]"]
end

subgraph group_translation["Translation"]
  node_home["Translator screen<br/>[home.view.dart]"]
  node_translate["Translate text"]
  node_translation_repo["Translation repository"]
  node_translation_service["Translation service"]
  node_mlkit["On-device ML Kit"]
  node_speech_input["Speech input"]
  node_tts["Text-to-speech<br/>[tts.helper.dart]"]
end

subgraph group_languages["Offline languages"]
  node_offline_view["Offline languages screen"]
  node_language_provider["Language actions"]
  node_language_usecases["Language management"]
  node_language_repo["Language repository"]
  node_language_source["Language model source"]
end

subgraph group_bookmarks["Bookmarks"]
  node_bookmark_view["Bookmarks screen"]
  node_bookmark_controller["Bookmark actions"]
  node_bookmark_usecases["Bookmark operations"]
  node_bookmark_repo["Bookmark repository"]
  node_bookmark_store[("Local bookmarks")]
end

subgraph group_settings["Settings"]
  node_settings_view["Settings screen<br/>[setting_view.dart]"]
  node_settings_provider["Settings actions"]
  node_settings_usecases["Settings operations<br/>[get_settings.dart]"]
  node_settings_repo["Settings repository"]
  node_settings_store[("Local settings")]
end

node_user(("App user"))

node_user -.->|"opens app"| node_app_shell
node_app_shell -.->|"sets routes"| node_router
node_user -.->|"enters text"| node_home
node_home -.->|"requests translation"| node_translate
node_translate -.->|"delegates to"| node_translation_repo
node_translation_repo -.->|"uses service"| node_translation_service
node_translation_service -->|"runs on-device"| node_mlkit
node_user -->|"provides speech"| node_speech_input
node_home -->|"speaks text"| node_tts
node_user -->|"manages models"| node_offline_view
node_offline_view -.->|"dispatches actions"| node_language_provider
node_language_provider -.->|"requests operation"| node_language_usecases
node_language_usecases -.->|"delegates to"| node_language_repo
node_language_repo -.->|"uses source"| node_language_source
node_user -->|"manages bookmarks"| node_bookmark_view
node_bookmark_view -.->|"dispatches actions"| node_bookmark_controller
node_bookmark_controller -.->|"requests operation"| node_bookmark_usecases
node_bookmark_usecases -.->|"delegates to"| node_bookmark_repo
node_bookmark_repo -.->|"uses local store"| node_bookmark_store
node_user -->|"changes settings"| node_settings_view
node_settings_view -.->|"dispatches actions"| node_settings_provider
node_settings_provider -.->|"requests operation"| node_settings_usecases
node_settings_usecases -.->|"delegates to"| node_settings_repo
node_settings_repo -.->|"uses local store"| node_settings_store

click node_app_shell "https://github.com/aazmii/translator/blob/main/lib/src/app.dart"
click node_router "https://github.com/aazmii/translator/blob/main/lib/src/config/router/view/router.dart"
click node_home "https://github.com/aazmii/translator/blob/main/lib/src/modules/home/presentation/home.view/home.view.dart"
click node_translate "https://github.com/aazmii/translator/blob/main/lib/src/modules/home/domain/usecases/translate_text.dart"
click node_translation_repo "https://github.com/aazmii/translator/blob/main/lib/src/modules/home/data/repository/translation.repo.impl.dart"
click node_translation_service "https://github.com/aazmii/translator/blob/main/lib/src/modules/home/data/datasources/translation_service_data_source.dart"
click node_speech_input "https://github.com/aazmii/translator/blob/main/lib/src/modules/home/presentation/home.view/components/speech.listening/speech.listening.dialog.dart"
click node_tts "https://github.com/aazmii/translator/blob/main/lib/src/modules/home/presentation/home.view/helpers/tts.helper.dart"
click node_offline_view "https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/presentation/view/offline.languages.view.dart"
click node_language_provider "https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/presentation/providers/offline.languages.provider.dart"
click node_language_usecases "https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/domain/usecases/download_language.dart"
click node_language_repo "https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/data/repositories/offline_language_repository_impl.dart"
click node_language_source "https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/data/datasources/language_model_data_source.dart"
click node_bookmark_view "https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/presentation/view/bookmarks.view.dart"
click node_bookmark_controller "https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/presentation/providers/bookmarks.controller.dart"
click node_bookmark_usecases "https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/domain/usecases/save.bookmark.usecase.dart"
click node_bookmark_repo "https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/data/repositories/bookmarks.repository.impl.dart"
click node_bookmark_store "https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/data/datasource/bookmarks.local.datasource.impl.dart"
click node_settings_view "https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/presentation/view/setting_view.dart"
click node_settings_provider "https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/presentation/providers/settings_provider.dart"
click node_settings_usecases "https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/domain/usecases/get_settings.dart"
click node_settings_repo "https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/data/repositories/setting.repository.dart"
click node_settings_store "https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/data/datasources/settings_local_data_source.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_app_shell,node_router,node_user toneBlue
class node_home,node_translate,node_translation_repo,node_translation_service,node_mlkit,node_speech_input,node_tts toneAmber
class node_offline_view,node_language_provider,node_language_usecases,node_language_repo,node_language_source toneMint
class node_bookmark_view,node_bookmark_controller,node_bookmark_usecases,node_bookmark_repo,node_bookmark_store toneRose
class node_settings_view,node_settings_provider,node_settings_usecases,node_settings_repo,node_settings_store toneIndigo
```

## Components

### App shell

- [App shell](https://github.com/aazmii/translator/blob/main/lib/src/app.dart): `lib/src/app.dart`
- [Route setup](https://github.com/aazmii/translator/blob/main/lib/src/config/router/view/router.dart): `lib/src/config/router/view/router.dart`

### Translation

- [Translator screen](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/presentation/home.view/home.view.dart): `lib/src/modules/home/presentation/home.view/home.view.dart`
- [Translate text](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/domain/usecases/translate_text.dart): `lib/src/modules/home/domain/usecases/translate_text.dart`
- [Translation repository](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/data/repository/translation.repo.impl.dart): `lib/src/modules/home/data/repository/translation.repo.impl.dart`
- [Translation service](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/data/datasources/translation_service_data_source.dart): `lib/src/modules/home/data/datasources/translation_service_data_source.dart`
- **On-device ML Kit**
- [Speech input](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/presentation/home.view/components/speech.listening/speech.listening.dialog.dart): `lib/src/modules/home/presentation/home.view/components/speech.listening/speech.listening.dialog.dart`
- [Text-to-speech](https://github.com/aazmii/translator/blob/main/lib/src/modules/home/presentation/home.view/helpers/tts.helper.dart): `lib/src/modules/home/presentation/home.view/helpers/tts.helper.dart`

### Offline languages

- [Offline languages screen](https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/presentation/view/offline.languages.view.dart): `lib/src/modules/languages/presentation/view/offline.languages.view.dart`
- [Language actions](https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/presentation/providers/offline.languages.provider.dart): `lib/src/modules/languages/presentation/providers/offline.languages.provider.dart`
- [Language management](https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/domain/usecases/download_language.dart): `lib/src/modules/languages/domain/usecases/download_language.dart`
- [Language repository](https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/data/repositories/offline_language_repository_impl.dart): `lib/src/modules/languages/data/repositories/offline_language_repository_impl.dart`
- [Language model source](https://github.com/aazmii/translator/blob/main/lib/src/modules/languages/data/datasources/language_model_data_source.dart): `lib/src/modules/languages/data/datasources/language_model_data_source.dart`

### Bookmarks

- [Bookmarks screen](https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/presentation/view/bookmarks.view.dart): `lib/src/modules/bookmarks/presentation/view/bookmarks.view.dart`
- [Bookmark actions](https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/presentation/providers/bookmarks.controller.dart): `lib/src/modules/bookmarks/presentation/providers/bookmarks.controller.dart`
- [Bookmark operations](https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/domain/usecases/save.bookmark.usecase.dart): `lib/src/modules/bookmarks/domain/usecases/save.bookmark.usecase.dart`
- [Bookmark repository](https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/data/repositories/bookmarks.repository.impl.dart): `lib/src/modules/bookmarks/data/repositories/bookmarks.repository.impl.dart`
- [Local bookmarks](https://github.com/aazmii/translator/blob/main/lib/src/modules/bookmarks/data/datasource/bookmarks.local.datasource.impl.dart): `lib/src/modules/bookmarks/data/datasource/bookmarks.local.datasource.impl.dart`

### Settings

- [Settings screen](https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/presentation/view/setting_view.dart): `lib/src/modules/setting/presentation/view/setting_view.dart`
- [Settings actions](https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/presentation/providers/settings_provider.dart): `lib/src/modules/setting/presentation/providers/settings_provider.dart`
- [Settings operations](https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/domain/usecases/get_settings.dart): `lib/src/modules/setting/domain/usecases/get_settings.dart`
- [Settings repository](https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/data/repositories/setting.repository.dart): `lib/src/modules/setting/data/repositories/setting.repository.dart`
- [Local settings](https://github.com/aazmii/translator/blob/main/lib/src/modules/setting/data/datasources/settings_local_data_source.dart): `lib/src/modules/setting/data/datasources/settings_local_data_source.dart`

### Other components

- **App user**

## Connections

- App user → App shell: opens app
- App shell → Route setup: sets routes
- App user → Translator screen: enters text
- Translator screen → Translate text: requests translation
- Translate text → Translation repository: delegates to
- Translation repository → Translation service: uses service
- Translation service → On-device ML Kit: runs on-device (evidence: `README.md`)
- App user → Speech input: provides speech (evidence: `README.md`)
- Translator screen → Text-to-speech: speaks text (evidence: `README.md`)
- App user → Offline languages screen: manages models (evidence: `README.md`)
- Offline languages screen → Language actions: dispatches actions
- Language actions → Language management: requests operation
- Language management → Language repository: delegates to
- Language repository → Language model source: uses source
- App user → Bookmarks screen: manages bookmarks (evidence: `README.md`)
- Bookmarks screen → Bookmark actions: dispatches actions
- Bookmark actions → Bookmark operations: requests operation
- Bookmark operations → Bookmark repository: delegates to
- Bookmark repository → Local bookmarks: uses local store
- App user → Settings screen: changes settings (evidence: `README.md`)
- Settings screen → Settings actions: dispatches actions
- Settings actions → Settings operations: requests operation
- Settings operations → Settings repository: delegates to
- Settings repository → Local settings: uses local store
