# davidf555/falafacil architecture

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

## Overview

Fala Fácil is an offline-first Android AAC-style voice communication app. Users compose text with letter/number keyboards, can use word suggestions or configurable quick phrases, and send speech through the device’s text-to-speech engine; preferences and recent history remain on-device. The activity initializes speech and hosts the Compose interface, while the ViewModel owns composition state, speech behavior, filtering, and persistence. The sampled excerpts show the main UI actions and storage/speech logic, but not every settings or history interaction, so those documented branches are represented without speculative call paths.

Main entry points: [`app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt) (Communication ViewModel), [`app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt) (Compose screen), [`app/src/main/java/br/com/falafacil/MainActivity.kt`](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/MainActivity.kt) (Android activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Compose experience"]
  node_activity["Android activity<br/>[MainActivity.kt]"]
  node_screen["Compose screen<br/>[FalaFacilScreen.kt]"]
  node_keyboard["Keyboards<br/>[FalaFacilScreen.kt]"]
  node_suggestions["Word suggestions<br/>[FalaFacilScreen.kt]"]
  node_quickphrases["Quick phrases<br/>[FalaFacilScreen.kt]"]
  node_settings["Settings<br/>[FalaFacilScreen.kt]"]
  node_history["Recent history<br/>[FalaFacilScreen.kt]"]
end

subgraph group_domain["Communication state"]
  node_viewmodel["Communication ViewModel"]
  node_textstate["Draft and status"]
  node_speechguard["Speech filtering"]
end

subgraph group_device["Device services"]
  node_preferences[("Local preferences")]
  node_tts["Device text-to-speech"]
end

node_user(("App user"))
node_deviceuser(("Device user"))

node_user -->|"opens app"| node_activity
node_activity -->|"initializes speech"| node_viewmodel
node_activity -->|"hosts"| node_screen
node_screen -->|"renders"| node_keyboard
node_screen -->|"shows"| node_suggestions
node_screen -.->|"offers"| node_quickphrases
node_screen -.->|"offers"| node_settings
node_screen -.->|"offers"| node_history
node_keyboard -->|"dispatches actions"| node_viewmodel
node_screen -->|"observes state"| node_viewmodel
node_viewmodel -->|"updates"| node_textstate
node_viewmodel -->|"filters phrases"| node_speechguard
node_viewmodel -->|"speaks text"| node_tts
node_tts -->|"reads aloud"| node_deviceuser
node_viewmodel -->|"stores settings"| node_preferences
node_viewmodel -->|"stores recent phrases"| node_preferences
node_preferences -.->|"loads preferences"| node_viewmodel

click node_activity "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/MainActivity.kt"
click node_screen "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt"
click node_keyboard "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt"
click node_suggestions "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt"
click node_quickphrases "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt"
click node_settings "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt"
click node_history "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt"
click node_viewmodel "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt"
click node_textstate "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt"
click node_speechguard "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt"
click node_preferences "https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.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_activity,node_screen,node_keyboard,node_suggestions,node_quickphrases,node_settings,node_history,node_user,node_deviceuser toneBlue
class node_viewmodel,node_textstate,node_speechguard toneAmber
class node_preferences,node_tts toneMint
```

## Components

### Compose experience

- [Android activity](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/MainActivity.kt): `app/src/main/java/br/com/falafacil/MainActivity.kt`
- [Compose screen](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt): `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`
- [Keyboards](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt): `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`
- [Word suggestions](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt): `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`
- [Quick phrases](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt): `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`
- [Settings](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt): `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`
- [Recent history](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt): `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`

### Communication state

- [Communication ViewModel](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt): `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`
- [Draft and status](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt): `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`
- [Speech filtering](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt): `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`

### Device services

- [Local preferences](https://github.com/davidf555/falafacil/blob/main/app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt): `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`
- **Device text-to-speech**

### Other components

- **App user**
- **Device user**

## Connections

- App user → Android activity: opens app (evidence: `app/src/main/java/br/com/falafacil/MainActivity.kt`)
- Android activity → Communication ViewModel: initializes speech (evidence: `app/src/main/java/br/com/falafacil/MainActivity.kt`)
- Android activity → Compose screen: hosts (evidence: `app/src/main/java/br/com/falafacil/MainActivity.kt`)
- Compose screen → Keyboards: renders (evidence: `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`)
- Compose screen → Word suggestions: shows (evidence: `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`)
- Compose screen → Quick phrases: offers (evidence: `README.md`)
- Compose screen → Settings: offers (evidence: `README.md`)
- Compose screen → Recent history: offers (evidence: `README.md`)
- Keyboards → Communication ViewModel: dispatches actions (evidence: `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`)
- Compose screen → Communication ViewModel: observes state (evidence: `app/src/main/java/br/com/falafacil/ui/FalaFacilScreen.kt`)
- Communication ViewModel → Draft and status: updates (evidence: `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`)
- Communication ViewModel → Speech filtering: filters phrases (evidence: `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`)
- Communication ViewModel → Device text-to-speech: speaks text (evidence: `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`)
- Device text-to-speech → Device user: reads aloud (evidence: `README.md`)
- Communication ViewModel → Local preferences: stores settings (evidence: `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`)
- Communication ViewModel → Local preferences: stores recent phrases (evidence: `app/src/main/java/br/com/falafacil/FalaFacilViewModel.kt`)
- Local preferences → Communication ViewModel: loads preferences (evidence: `README.md`)
