# udatheja/u-type-keyboard architecture

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

- Interactive diagram: https://gitdiagram.com/udatheja/u-type-keyboard
- Repository: https://github.com/udatheja/u-type-keyboard

## Overview

U Type is an offline Android Sinhala/English keyboard. The main workflow is user typing into an app, with the IME composing Singlish as Sinhala, offering word suggestions, and committing text to the focused editor. The keyboard also hosts emoji, clipboard, text-editing, stylish-font, and voice panels; settings and backup form a separate management branch. Local settings, dictionaries, clipboard data, and emoji recents provide persistence. Edges follow README statements or shown source/index references; several unsampled feature implementations are represented only at their supported directory or module path.

Main entry points: [`app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt) (IME service), [`app/src/main/java/com/udara/Utype/settings/SettingsViewModel.kt`](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/SettingsViewModel.kt) (Settings view model), [`app/src/main/java/com/udara/Utype/UTypeApplication.kt`](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/UTypeApplication.kt) (Application bootstrap), [`app/src/main/java/com/udara/Utype/engine/SuggestionEngine.kt`](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SuggestionEngine.kt) (Suggestion engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_typing["Keyboard and Typing"]
  node_ime["IME service"]
  node_layouts["Keyboard layouts<br/>[KeyboardLayouts.kt]"]
  node_canvas["Keyboard canvas"]
  node_topstrip["Tool strip<br/>[TopStripView.kt]"]
  node_translit["Sinhala transliterator"]
  node_map["Phonetic map<br/>[SinhalaMap.kt]"]
  node_suggestions["Suggestion engine"]
  node_symspell["Word index<br/>[SymSpellIndex.kt]"]
  node_bigram["Bigram model<br/>[BigramModel.kt]"]
  node_cursor["Cursor word extractor"]
end

subgraph group_tools["Keyboard Tools"]
  node_emoji["Emoji panel<br/>[EmojiPanelView.kt]"]
  node_emoji_data["Emoji data<br/>[EmojiData.kt]"]
  node_clipboard_panel["Clipboard panel"]
  node_text_editor["Text editor panel"]
  node_fonts_panel["Stylish fonts panel"]
  node_font_engine["Font engine"]
  node_voice_panel["Voice panel<br/>[VoicePanelView.kt]"]
  node_voice_permission["Voice permission"]
end

subgraph group_data["Local Data"]
  node_app["Application bootstrap"]
  node_database[("Room database<br/>[UTypeDatabase.kt]")]
  node_clipboard_repo["Clipboard repository"]
  node_crypto["Clipboard encryption<br/>[ClipboardCrypto.kt]"]
  node_settings_repo["Settings repository"]
  node_keyboard_settings["Keyboard settings"]
end

subgraph group_management["Settings and Backup"]
  node_dashboard["Settings dashboard"]
  node_onboarding["Onboarding"]
  node_settings_vm["Settings view model"]
  node_typing_settings["Typing settings"]
  node_dictionary["Personal dictionary"]
  node_phonetic_guide["Phonetic guide"]
  node_shortcuts["Shortcuts and data"]
end

node_user(("Keyboard user"))
node_editor["Focused editor"]
node_speech["Android speech recognizer"]

node_user -->|"types with"| node_ime
node_ime -->|"commits text"| node_editor
node_ime -->|"uses layouts"| node_layouts
node_ime -->|"hosts keyboard"| node_canvas
node_ime -->|"hosts strip"| node_topstrip
node_ime -->|"transliterates input"| node_translit
node_translit -->|"matches phonetics"| node_map
node_ime -->|"requests suggestions"| node_suggestions
node_suggestions -->|"indexes words"| node_symspell
node_suggestions -->|"scores candidates"| node_bigram
node_ime -->|"extracts cursor word"| node_cursor
node_ime -->|"hosts panel"| node_emoji
node_emoji -->|"loads emoji data"| node_emoji_data
node_ime -->|"hosts panel"| node_clipboard_panel
node_ime -->|"hosts panel"| node_text_editor
node_ime -->|"hosts panel"| node_fonts_panel
node_fonts_panel -->|"converts text"| node_font_engine
node_ime -->|"hosts panel"| node_voice_panel
node_voice_panel -->|"requests permission"| node_voice_permission
node_voice_panel -.->|"recognizes speech"| node_speech
node_app -->|"initializes"| node_database
node_app -->|"creates repository"| node_settings_repo
node_app -->|"creates repository"| node_clipboard_repo
node_clipboard_repo -->|"encrypts clipboard"| node_crypto
node_clipboard_repo -->|"persists items"| node_database
node_settings_repo -->|"stores preferences"| node_keyboard_settings
node_canvas -->|"reads appearance"| node_keyboard_settings
node_app -->|"creates engine"| node_suggestions
node_dashboard -.->|"uses state"| node_settings_vm
node_onboarding -.->|"configures setup"| node_settings_vm
node_typing_settings -->|"updates settings"| node_settings_vm
node_dictionary -->|"manages words"| node_settings_vm
node_phonetic_guide -->|"demonstrates typing"| node_translit
node_shortcuts -->|"manages data"| node_settings_vm
node_settings_vm -->|"observes preferences"| node_settings_repo

click node_ime "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt"
click node_layouts "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/layouts/KeyboardLayouts.kt"
click node_canvas "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/views/KeyboardCanvasView.kt"
click node_topstrip "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/views/TopStripView.kt"
click node_translit "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SinhalaTransliterator.kt"
click node_map "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SinhalaMap.kt"
click node_suggestions "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SuggestionEngine.kt"
click node_symspell "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SymSpellIndex.kt"
click node_bigram "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/BigramModel.kt"
click node_cursor "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/ime/CursorWordExtractor.kt"
click node_emoji "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/EmojiPanelView.kt"
click node_emoji_data "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/EmojiData.kt"
click node_clipboard_panel "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/ClipboardPanelView.kt"
click node_text_editor "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/TextEditorPanelView.kt"
click node_fonts_panel "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/StylishFontsPanelView.kt"
click node_font_engine "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/StylishFontEngine.kt"
click node_voice_panel "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/VoicePanelView.kt"
click node_voice_permission "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/voice/VoicePermissionActivity.kt"
click node_app "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/UTypeApplication.kt"
click node_database "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/UTypeDatabase.kt"
click node_clipboard_repo "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/ClipboardRepository.kt"
click node_crypto "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/ClipboardCrypto.kt"
click node_settings_repo "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/SettingsRepository.kt"
click node_keyboard_settings "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/KeyboardSettings.kt"
click node_dashboard "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/HomeDashboardScreen.kt"
click node_onboarding "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/OnboardingScreen.kt"
click node_settings_vm "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/SettingsViewModel.kt"
click node_typing_settings "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/TypingSettingsScreen.kt"
click node_dictionary "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/PersonalDictionarySection.kt"
click node_phonetic_guide "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/PhoneticIndexScreen.kt"
click node_shortcuts "https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/ShortcutsAndDataScreen.kt"

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_ime,node_layouts,node_canvas,node_topstrip,node_translit,node_map,node_suggestions,node_symspell,node_bigram,node_cursor,node_user toneBlue
class node_emoji,node_emoji_data,node_clipboard_panel,node_text_editor,node_fonts_panel,node_font_engine,node_voice_panel,node_voice_permission toneAmber
class node_app,node_database,node_clipboard_repo,node_crypto,node_settings_repo,node_keyboard_settings toneMint
class node_dashboard,node_onboarding,node_settings_vm,node_typing_settings,node_dictionary,node_phonetic_guide,node_shortcuts toneRose
class node_editor,node_speech toneIndigo
```

## Components

### Keyboard and Typing

- [IME service](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt): `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`
- [Keyboard layouts](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/layouts/KeyboardLayouts.kt): `app/src/main/java/com/udara/Utype/layouts/KeyboardLayouts.kt`
- [Keyboard canvas](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/views/KeyboardCanvasView.kt): `app/src/main/java/com/udara/Utype/views/KeyboardCanvasView.kt`
- [Tool strip](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/views/TopStripView.kt): `app/src/main/java/com/udara/Utype/views/TopStripView.kt`
- [Sinhala transliterator](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SinhalaTransliterator.kt): `app/src/main/java/com/udara/Utype/engine/SinhalaTransliterator.kt`
- [Phonetic map](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SinhalaMap.kt): `app/src/main/java/com/udara/Utype/engine/SinhalaMap.kt`
- [Suggestion engine](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SuggestionEngine.kt): `app/src/main/java/com/udara/Utype/engine/SuggestionEngine.kt`
- [Word index](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/SymSpellIndex.kt): `app/src/main/java/com/udara/Utype/engine/SymSpellIndex.kt`
- [Bigram model](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/BigramModel.kt): `app/src/main/java/com/udara/Utype/engine/BigramModel.kt`
- [Cursor word extractor](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/ime/CursorWordExtractor.kt): `app/src/main/java/com/udara/Utype/ime/CursorWordExtractor.kt`

### Keyboard Tools

- [Emoji panel](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/EmojiPanelView.kt): `app/src/main/java/com/udara/Utype/panels/EmojiPanelView.kt`
- [Emoji data](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/EmojiData.kt): `app/src/main/java/com/udara/Utype/engine/EmojiData.kt`
- [Clipboard panel](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/ClipboardPanelView.kt): `app/src/main/java/com/udara/Utype/panels/ClipboardPanelView.kt`
- [Text editor panel](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/TextEditorPanelView.kt): `app/src/main/java/com/udara/Utype/panels/TextEditorPanelView.kt`
- [Stylish fonts panel](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/StylishFontsPanelView.kt): `app/src/main/java/com/udara/Utype/panels/StylishFontsPanelView.kt`
- [Font engine](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/engine/StylishFontEngine.kt): `app/src/main/java/com/udara/Utype/engine/StylishFontEngine.kt`
- [Voice panel](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/panels/VoicePanelView.kt): `app/src/main/java/com/udara/Utype/panels/VoicePanelView.kt`
- [Voice permission](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/voice/VoicePermissionActivity.kt): `app/src/main/java/com/udara/Utype/voice/VoicePermissionActivity.kt`

### Local Data

- [Application bootstrap](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/UTypeApplication.kt): `app/src/main/java/com/udara/Utype/UTypeApplication.kt`
- [Room database](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/UTypeDatabase.kt): `app/src/main/java/com/udara/Utype/data/UTypeDatabase.kt`
- [Clipboard repository](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/ClipboardRepository.kt): `app/src/main/java/com/udara/Utype/data/ClipboardRepository.kt`
- [Clipboard encryption](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/ClipboardCrypto.kt): `app/src/main/java/com/udara/Utype/data/ClipboardCrypto.kt`
- [Settings repository](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/SettingsRepository.kt): `app/src/main/java/com/udara/Utype/data/SettingsRepository.kt`
- [Keyboard settings](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/data/KeyboardSettings.kt): `app/src/main/java/com/udara/Utype/data/KeyboardSettings.kt`

### Settings and Backup

- [Settings dashboard](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/HomeDashboardScreen.kt): `app/src/main/java/com/udara/Utype/settings/HomeDashboardScreen.kt`
- [Onboarding](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/OnboardingScreen.kt): `app/src/main/java/com/udara/Utype/settings/OnboardingScreen.kt`
- [Settings view model](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/SettingsViewModel.kt): `app/src/main/java/com/udara/Utype/settings/SettingsViewModel.kt`
- [Typing settings](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/TypingSettingsScreen.kt): `app/src/main/java/com/udara/Utype/settings/TypingSettingsScreen.kt`
- [Personal dictionary](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/PersonalDictionarySection.kt): `app/src/main/java/com/udara/Utype/settings/PersonalDictionarySection.kt`
- [Phonetic guide](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/PhoneticIndexScreen.kt): `app/src/main/java/com/udara/Utype/settings/PhoneticIndexScreen.kt`
- [Shortcuts and data](https://github.com/udatheja/u-type-keyboard/blob/main/app/src/main/java/com/udara/Utype/settings/ShortcutsAndDataScreen.kt): `app/src/main/java/com/udara/Utype/settings/ShortcutsAndDataScreen.kt`

### Other components

- **Keyboard user**
- **Focused editor**
- **Android speech recognizer**

## Connections

- Keyboard user → IME service: types with
- IME service → Focused editor: commits text (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- IME service → Keyboard layouts: uses layouts (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- IME service → Keyboard canvas: hosts keyboard (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- IME service → Tool strip: hosts strip (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- IME service → Sinhala transliterator: transliterates input (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- Sinhala transliterator → Phonetic map: matches phonetics (evidence: `app/src/main/java/com/udara/Utype/engine/SinhalaTransliterator.kt`)
- IME service → Suggestion engine: requests suggestions (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- Suggestion engine → Word index: indexes words (evidence: `app/src/main/java/com/udara/Utype/engine/SuggestionEngine.kt`)
- Suggestion engine → Bigram model: scores candidates (evidence: `app/src/main/java/com/udara/Utype/engine/SuggestionEngine.kt`)
- IME service → Cursor word extractor: extracts cursor word (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- IME service → Emoji panel: hosts panel (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- Emoji panel → Emoji data: loads emoji data (evidence: `app/src/main/java/com/udara/Utype/panels/EmojiPanelView.kt`)
- IME service → Clipboard panel: hosts panel (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- IME service → Text editor panel: hosts panel (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- IME service → Stylish fonts panel: hosts panel (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- Stylish fonts panel → Font engine: converts text (evidence: `app/src/main/java/com/udara/Utype/panels/StylishFontsPanelView.kt`)
- IME service → Voice panel: hosts panel (evidence: `app/src/main/java/com/udara/Utype/ime/UTypeInputMethodService.kt`)
- Voice panel → Voice permission: requests permission (evidence: `app/src/main/java/com/udara/Utype/panels/VoicePanelView.kt`)
- Voice panel → Android speech recognizer: recognizes speech
- Application bootstrap → Room database: initializes (evidence: `app/src/main/java/com/udara/Utype/UTypeApplication.kt`)
- Application bootstrap → Settings repository: creates repository (evidence: `app/src/main/java/com/udara/Utype/UTypeApplication.kt`)
- Application bootstrap → Clipboard repository: creates repository (evidence: `app/src/main/java/com/udara/Utype/UTypeApplication.kt`)
- Clipboard repository → Clipboard encryption: encrypts clipboard (evidence: `app/src/main/java/com/udara/Utype/data/ClipboardRepository.kt`)
- Clipboard repository → Room database: persists items (evidence: `app/src/main/java/com/udara/Utype/UTypeApplication.kt`)
- Settings repository → Keyboard settings: stores preferences (evidence: `app/src/main/java/com/udara/Utype/data/SettingsRepository.kt`)
- Keyboard canvas → Keyboard settings: reads appearance (evidence: `app/src/main/java/com/udara/Utype/views/KeyboardCanvasView.kt`)
- Application bootstrap → Suggestion engine: creates engine (evidence: `app/src/main/java/com/udara/Utype/UTypeApplication.kt`)
- Settings dashboard → Settings view model: uses state
- Onboarding → Settings view model: configures setup
- Typing settings → Settings view model: updates settings (evidence: `app/src/main/java/com/udara/Utype/settings/TypingSettingsScreen.kt`)
- Personal dictionary → Settings view model: manages words (evidence: `app/src/main/java/com/udara/Utype/settings/PersonalDictionarySection.kt`)
- Phonetic guide → Sinhala transliterator: demonstrates typing (evidence: `app/src/main/java/com/udara/Utype/settings/PhoneticIndexScreen.kt`)
- Shortcuts and data → Settings view model: manages data (evidence: `app/src/main/java/com/udara/Utype/settings/ShortcutsAndDataScreen.kt`)
- Settings view model → Settings repository: observes preferences (evidence: `app/src/main/java/com/udara/Utype/settings/SettingsViewModel.kt`)
