How austinf02/english-flashcards works
Conf English is a browser-based English vocabulary flashcard and quiz app, with three decks, Japanese meanings and examples, pronunciation audio, quiz history, and device-local progress. The main workflow runs from a learner selecting cards in the app through study or quiz interactions; the app records progress locally and, when configured and signed in, synchronizes it through an authenticated API. The backend validates and applies progress operations. README documents deployment services and optional sign-in/sync; unsampled runtime wiring is shown only where documented.
Main entry points: app.ts Study app · index.py Lambda entrypoint · auth.ts Cognito auth · cards.ts Deck content
Components 18
Study experience
- Study app
src/app.ts - Deck content
src/cards.ts - Quiz engine
src/quiz.ts - Audio playback
src/audio.ts - Quiz history
src/quizHistory.ts
Progress and sync
- Progress model
src/progress.ts - Device tracking
src/device.ts - Local progress
src/storage.ts - Cloud sync
src/cloud.ts
Identity
- Runtime config
src/config.ts - Cognito auth
src/auth.ts
Progress backend
- Lambda entrypoint
backend/index.py - Progress handler
backend/handler.py
Content assets
- Pronunciation MP3s
public/audio
Other components
- Learner
- Amazon Cognito
- Progress API
- Progress table
Connections 22
- Learner → Study app: studies with
README.md - Study app → Deck content: loads decks
src/app.ts - Study app → Quiz engine: builds and scores
src/app.ts - Study app → Audio playback: plays clips
src/app.ts - Study app → Quiz history: loads history
src/app.ts - Study app → Progress model: records progress
src/app.ts - Study app → Device tracking: tracks device
src/app.ts - Study app → Local progress: saves progress
src/app.ts - Study app → Cloud sync: syncs progress
src/app.ts - Study app → Runtime config: loads config
src/app.ts - Study app → Cognito auth: handles login
src/app.ts - Local progress → Progress model: uses model
src/storage.ts - Deck content → Pronunciation MP3s: references clips
src/cards.ts - Study app → Pronunciation MP3s: plays pronunciation
README.md - Cloud sync → Progress API: sends sync requests
README.md - Cognito auth → Amazon Cognito: authenticates with
src/auth.ts - Runtime config → Cognito auth: provides settings
src/config.ts - Progress API → Lambda entrypoint: routes requests
README.md - Lambda entrypoint → Progress handler: calls handler
backend/index.py - Lambda entrypoint → Progress table: reads and writes
backend/index.py - Progress API → Amazon Cognito: authorizes requests
README.md - Lambda entrypoint → Amazon Cognito: deletes user
backend/index.py