How mavrk-mose/konglish works
Konglish is a single-screen, mobile-first Korean↔English live translator. The main workflow runs from direction and listening controls through speech recognition, translation, and live display, then saves completed pairs for review, editing, deletion, and text export. Model provisioning gates offline translation; transcript storage is local. The graph follows the documented composition and sampled call sites. Several UI and runtime details are documented but their implementation was not sampled, so those relationships use README evidence.
Main entry points: index.tsx Home screen · use-transcript.ts Transcript actions · use-speech-translation.ts Speech workflow · live-controls.tsx Live controls
Components 19
App experience
- Router shell
app/_layout.tsx - Home screen
app/index.tsx - Live controls
components/live-controls.tsx - Live transcript
components/live-transcript.tsx - Speech status
components/speech-status-footer.tsx - Offline setup UI
components/offline-setup.tsx - Transcript editor
components/transcript-editor-modal.tsx
Speech and translation
- Speech workflow
hooks/use-speech-translation.ts - Speech recognition
- Model provisioning
hooks/use-translation-models.ts - On-device translation
Transcript history
- Transcript actions
hooks/use-transcript.ts - History review
app/index.tsx - Transcript store
hooks/use-transcript.ts - Text export and sharing
hooks/use-transcript.ts
Shared foundations
- Transcript entries
types/transcript.ts - Translation direction
types/translation.ts - Theme tokens
constants/theme.ts
Other components
- User
Connections 28
- User → Home screen: opens
README.md - Router shell → Home screen: routes to
README.md - Home screen → Speech workflow: configures
app/index.tsx - Home screen → Model provisioning: checks readiness
app/index.tsx - Home screen → Transcript actions: loads history
app/index.tsx - Home screen → Live controls: renders
README.md - Home screen → Live transcript: renders
README.md - Home screen → Speech status: renders
README.md - Home screen → Offline setup UI: shows gate
README.md - Home screen → Transcript editor: opens
app/index.tsx - Live controls → Home screen: changes direction
README.md - Live controls → Speech workflow: toggles listening
README.md - Speech workflow → Speech recognition: starts capture
hooks/use-speech-translation.ts - Speech recognition → Speech workflow: emits results
hooks/use-speech-translation.ts - Speech workflow → On-device translation: translates text
README.md - Model provisioning → On-device translation: provisions packs
README.md - Home screen → Live transcript: provides live state
README.md - Speech workflow → Transcript actions: completes entries
README.md - Transcript actions → Transcript store: reads and writes
hooks/use-transcript.ts - Transcript actions → On-device translation: retranslates edits
hooks/use-transcript.ts - Home screen → History review: renders history
app/index.tsx - History review → Transcript actions: edits or deletes
README.md - Transcript actions → Text export and sharing: creates export
hooks/use-transcript.ts - User → Live controls: selects direction
README.md - User → Transcript editor: edits entries
README.md - Home screen → Theme tokens: uses colors
app/index.tsx - Transcript actions → Transcript entries: stores typed entries
hooks/use-transcript.ts - Home screen → Translation direction: sets direction
app/index.tsx