How mapledevstack/language-learning-app works
This is a full-stack Japanese-learning platform: learners use a web client for dictionary lookup, grammar, flashcard study, immersion, and account management; the client communicates with an Express REST API, with MongoDB holding user data and imported language datasets. The graph shows documented product capabilities and backend route wiring. Several feature services and frontend-to-endpoint mappings were not excerpted, so uncertain internal calls are omitted rather than inferred.
Main entry points: app.ts Express REST API · auth.service.ts Auth workflows · features Learning interface · DeckStudyPage.tsx Deck study UI
Components 20
Web client
- Learning interface
frontend/src/features - Study dashboard
frontend/src/features/dashboard/pages/DashboardPage.tsx - Deck study UI
frontend/src/features/decks/pages/DeckStudyPage.tsx - Dictionary UI
frontend/src/features/dictionary/pages/DictionaryPage.tsx - Grammar UI
frontend/src/features/grammar/pages/GrammarPage.tsx - Immersion UI
frontend/src/features/immersion/pages/ImmersionWatchPage.tsx
API foundation
- Express REST API
backend/src/app.ts - Authentication middleware
backend/src/middleware/authenticate.ts - Runtime configuration
backend/src/constants/env.ts
Learning features
- Deck management
backend/src/features/decks/deck.service.ts - Flashcard reviews
backend/src/features/flashcards/flashcard.service.ts - Dictionary search
backend/src/features/dictionary/dictionary.service.ts - Grammar resources
backend/src/features/grammar/grammar.service.ts - Immersion services
backend/src/features/immersion/immersion.service.ts
Identity and profile
- Auth routes
backend/src/features/auth/auth.routes.ts - Auth workflows
backend/src/features/auth/auth.service.ts - User services
backend/src/features/users/user.service.ts - Email delivery
Persistence
- MongoDB
Other components
- Learner
Connections 16
- Learner → Learning interface: uses
- Learning interface → Express REST API: calls REST API
- Express REST API → Auth routes: mounts routes
backend/src/app.ts - Express REST API → Authentication middleware: uses auth
backend/src/app.ts - Express REST API → Runtime configuration: reads settings
backend/src/app.ts - Auth routes → Auth workflows: dispatches to
backend/src/features/auth/auth.routes.ts - Auth workflows → MongoDB: reads and writes
backend/src/features/auth/auth.service.ts - Auth workflows → Email delivery: sends messages
backend/src/features/auth/auth.service.ts - Express REST API → User services: mounts user routes
backend/src/app.ts - Express REST API → Deck management: mounts deck routes
backend/src/app.ts - Express REST API → Flashcard reviews: mounts card routes
backend/src/app.ts - Express REST API → Dictionary search: mounts dictionary routes
backend/src/app.ts - Express REST API → Grammar resources: mounts grammar routes
backend/src/app.ts - Express REST API → Immersion services: mounts immersion routes
backend/src/app.ts - Deck study UI → Flashcard reviews: reviews cards
- Study dashboard → Deck study UI: offers study entry