How chuloo/mural works
Mural is a native iOS and Android language-learning app centered on adaptive voice and written conversation. Learners choose languages, practise in themed conversations, use optional meaning support, and build local vocabulary records from conversation evidence. The repository also contains a hosted API with account, voice-session, and minute-commerce capabilities; the README excerpt describes the clients more fully than those hosted features. Edges reflect README statements and source-index references; unshown client-to-hosted-service wiring is left unverified.
Main entry points: app.ts HTTP routes · auth.ts Authentication · ConversationCoordinator.swift Conversation coordination · hosted-voice.ts Hosted sessions
Components 22
Mobile clients
- iPhone app
apps/ios/App/RootView.swift - Android app
apps/android/app/src/main/java/chat/mural/MainActivity.kt - Network clients
apps/ios/App/APIClient.swift
Conversation learning
- Talk interface
apps/android/app/src/main/java/chat/mural/ui/TalkScreen.kt - Voice session
apps/android/app/src/main/java/chat/mural/VoiceConversationService.kt - Conversation coordination
apps/ios/App/ConversationCoordinator.swift - Teaching and pacing
apps/ios/Core/TeachingPolicy.swift - Language modules
apps/ios/Core/Languages/LanguageModule.swift - Meaning support
apps/ios/Core/MeaningController.swift - Learning records
apps/ios/Core/LearningEngine.swift - Local records
apps/ios/App/Storage.swift
Hosted voice
- Service startup
services/api/src/main.ts - HTTP routes
services/api/src/app.ts - Hosted sessions
services/api/src/hosted-voice.ts - Live provider
services/api/src/live-provider.ts
Accounts and commerce
- Authentication
services/api/src/auth.ts - Account admission
services/api/src/auth-admission.ts - Minute balances
services/api/src/minutes.ts - Credit ledger
services/api/src/ledger.ts - Web purchases
services/api/src/web-purchases.ts
Service persistence
- PostgreSQL
services/api/src/db.ts
Other components
- Learner
Connections 27
- Learner → iPhone app: uses
README.md - Learner → Android app: uses
README.md - iPhone app → Conversation coordination: practises with
README.md - Android app → Talk interface: opens
README.md - Talk interface → Voice session: supports voice
README.md - Conversation coordination → Teaching and pacing: adapts challenge
README.md - Conversation coordination → Language modules: uses language
apps/ios/Core/Languages/LanguageModule.swift - Conversation coordination → Meaning support: offers meanings
README.md - Learning records → Local records: persists learning
apps/ios/App/Storage.swift - Learner → Learning records: builds vocabulary
README.md - iPhone app → Network clients: requests services
- Android app → Network clients: requests services
- Service startup → HTTP routes: starts routes
services/api/src/main.ts - HTTP routes → Hosted sessions: routes sessions
services/api/src/app.ts - Hosted sessions → Live provider: parses context
services/api/src/hosted-voice.ts - Service startup → Authentication: loads auth
services/api/src/main.ts - HTTP routes → Authentication: authenticates
services/api/src/app.ts - Authentication → Credit ledger: locks wallet
services/api/src/auth.ts - Authentication → Minute balances: funds welcome
services/api/src/auth.ts - Hosted sessions → Credit ledger: reserves credit
services/api/src/hosted-voice.ts - Hosted sessions → Minute balances: reserves minutes
services/api/src/hosted-voice.ts - HTTP routes → Account admission: checks admission
services/api/src/app.ts - HTTP routes → Web purchases: serves purchase routes
services/api/src/app.ts - Authentication → PostgreSQL: queries
services/api/src/auth.ts - Credit ledger → PostgreSQL: transacts
services/api/src/ledger.ts - Minute balances → PostgreSQL: transacts
services/api/src/minutes.ts - Web purchases → PostgreSQL: queries
services/api/src/web-purchases.ts