How metilda-uw/metilda works
Metilda is an audio-analysis web app with a React frontend and Flask backend. Users sign in, upload or select audio, and work with pitch-analysis and annotation tools; results and files can then be reviewed or managed. The README also identifies learning, PELDA, conversion, collections, feedback, messaging, and administration capabilities. The graph preserves these as product areas, while sampled backend code shows database-backed routes and pitch-analysis services. Some feature internals and frontend-to-backend wiring were not sampled, so uncertain connections are omitted or marked dashed.
Main entry points: App.tsx App routing · AudioAnalysis.tsx Audio analysis · __init__.py Flask application · pitch_art_wizard.py Pitch and file routes
Components 23
Application and identity
- App routing
frontend/src/App.tsx - Authentication
frontend/src/Session/withAuthentication.tsx - Firebase integration
frontend/src/Firebase/firebase.ts
Audio and pitch work
- Pitch-art creation
frontend/src/Create/CreatePitchArt.tsx - Audio analysis
frontend/src/Create/AudioAnalysis.tsx - Pitch-art viewer
frontend/src/PitchArtWizard/PitchArtViewer/PitchArtDrawingWindow.tsx - PELDA annotation
frontend/src/Pelda/PeldaView.tsx - Audio converter
frontend/src/Converter/Converter.tsx - Audio state
frontend/src/store/audio/actions.tsx
Files and learning
- File workspace
frontend/src/MyFiles/MyFiles.tsx - Collections
frontend/src/Pages/Collections.tsx - Syllable learning
frontend/src/Learn/WordSyllableReview.tsx - Analysis history
frontend/src/History/History.tsx
Community and administration
- Feedback
frontend/src/Feedback/Feedback.tsx - Messaging
frontend/src/Notifications/Notifications.tsx - User administration
frontend/src/Admin/ManageUsers.tsx
Backend services
- Flask application
src/metilda/__init__.py - Pitch and file routes
src/metilda/controllers/pitch_art_wizard.py - Analysis services
src/metilda/services/audio_analysis.py - Praat integration
src/metilda/services/praat.py - Postgres access
src/metilda/controllers/Postgres.py - Collection and feedback routes
src/metilda/controllers/controller_firestore.py
Other components
- User
Connections 23
- User → App routing: uses
frontend/src/App.tsx - App routing → Authentication: wraps
frontend/src/App.tsx - App routing → Pitch-art creation: routes to
frontend/src/App.tsx - App routing → PELDA annotation: routes to
frontend/src/App.tsx - App routing → Syllable learning: routes to
frontend/src/App.tsx - App routing → File workspace: routes to
frontend/src/App.tsx - User → Audio analysis: analyzes audio
- Pitch-art creation → Audio analysis: uses
- Audio analysis → Audio state: updates
- PELDA annotation → Audio state: dispatches
frontend/src/Pelda/PeldaView.tsx - Syllable learning → Audio analysis: embeds
frontend/src/Learn/WordSyllableReview.tsx - Syllable learning → Pitch-art viewer: renders
frontend/src/Learn/WordSyllableReview.tsx - File workspace → Firebase integration: uses storage
frontend/src/MyFiles/MyFiles.tsx - User → Audio converter: converts audio
- Flask application → Pitch and file routes: registers routes
src/metilda/__init__.py - Flask application → Collection and feedback routes: registers routes
src/metilda/__init__.py - Pitch and file routes → Postgres access: queries
src/metilda/controllers/pitch_art_wizard.py - Collection and feedback routes → Postgres access: queries
src/metilda/controllers/controller_firestore.py - Pitch and file routes → Analysis services: calls
src/metilda/controllers/pitch_art_wizard.py - Pitch and file routes → Praat integration: calls
src/metilda/controllers/pitch_art_wizard.py - Audio analysis → Flask application: requests analysis
- PELDA annotation → Flask application: requests analysis
- File workspace → Flask application: requests file data