How isaluki/wycinanka works
Wycinanka is a Polish-learning web app. Learners choose a course lesson, work through generated exercises and a conversation, then save results that build a spaced-review deck; they can also use review and the app’s reference and practice features. The browser supports guest progress and offline sync, while the Worker provides account-backed progress and optional speech recognition and reminders. Edges are limited to relationships shown in the excerpts, SOURCE INDEX references, or README; unsampled feature internals are represented at their page or directory paths.
Main entry points: App.tsx App routing · index.ts Worker router · Lesson.tsx Lesson experience · Review.tsx Spaced review
Components 21
Course and lessons
- Course content
src/content/course.ts - Lesson experience
src/app/pages/Lesson.tsx - Exercise generation
src/app/lib/exercises.ts - Exercise session
src/app/components/Session.tsx - Progress rules
src/shared/engine.ts
Practice and references
- Spaced review
src/app/pages/Review.tsx - Graded reading
src/app/pages/Reading.tsx - Speaking practice
src/app/pages/Speaking.tsx - Learning references
src/app/pages/Grammar.tsx - Culture articles
src/app/pages/Culture.tsx - Learning tools
src/app/pages/Tools.tsx
Browser experience
- App routing
src/app/App.tsx - Progress store
src/app/lib/store.ts - Browser API client
src/app/lib/api.ts
Worker services
- Worker router
src/worker/index.ts - Account and sessions
src/worker/routes/auth.ts - Progress API
src/worker/routes/progress.ts - D1 data access
src/worker/store.ts - Speech recognition
src/worker/routes/speech.ts - Push reminders
src/worker/reminders.ts
Other components
- Learner
Connections 32
- Learner → App routing: uses
- App routing → Lesson experience: routes to
src/app/App.tsx - App routing → Spaced review: routes to
src/app/App.tsx - App routing → Graded reading: routes to
src/app/App.tsx - App routing → Speaking practice: routes to
src/app/App.tsx - App routing → Learning references: routes to
src/app/App.tsx - App routing → Culture articles: routes to
src/app/App.tsx - App routing → Learning tools: routes to
src/app/App.tsx - Lesson experience → Exercise generation: uses
- Exercise generation → Course content: draws content
src/app/lib/exercises.ts - Lesson experience → Exercise session: runs exercises
- Exercise session → Progress rules: records results
- Spaced review → Exercise session: runs review
src/app/pages/Review.tsx - Spaced review → Progress store: submits reviews
src/app/pages/Review.tsx - Progress rules → Course content: gets lesson cards
src/shared/engine.ts - Learner → Graded reading: reads graded texts
- Learner → Speaking practice: practises speech
- Learner → Learning references: consults
- Learner → Culture articles: explores
- Learner → Learning tools: uses
- Progress store → Browser API client: calls
src/app/lib/store.ts - Browser API client → Worker router: requests
- Worker router → Account and sessions: routes requests
src/worker/index.ts - Worker router → Progress API: routes requests
src/worker/index.ts - Progress API → Progress rules: uses rules
src/worker/routes/progress.ts - Progress API → D1 data access: loads and saves
src/worker/routes/progress.ts - Account and sessions → D1 data access: accesses account data
src/worker/routes/auth.ts - Worker router → Speech recognition: routes requests
src/worker/index.ts - Worker router → Push reminders: sends scheduled reminders
src/worker/index.ts - Learner → Account and sessions: may create account
- Learner → Speech recognition: may request transcription
- Learner → Push reminders: may enable reminders