How baeyoju/talinturo works
Talinturo is an FSL learning product for learners, families, instructors, and administrators. Learners authenticate, complete profile onboarding, then navigate learning paths and lessons, practice and activity experiences, and review vocabulary and progress; instructors manage learners and classrooms, while administrators manage content and the experimental Sign Lab. The React app routes these workflows through a shared HTTP client to Flask, which owns authentication, API behavior, and PostgreSQL access. Arrows are limited to relationships explicit in the README or shown excerpts; several feature-to-API relationships are documented only at a high level.
Main entry points: routes.jsx Role-based routes · api.js HTTP API client · LearnerAuthPage.jsx Sign-in and signup · LessonViewerPage.jsx Video lessons and quizzes
Components 22
App shell
- React app shell
frontend/src/app/App.jsx - Role-based routes
frontend/src/app/routes.jsx - Sign-in and signup
frontend/src/features/auth/pages/LearnerAuthPage.jsx - Session restoration
frontend/src/app/hooks/useSession.js - Profile onboarding
frontend/src/features/onboarding/pages/ProfileSetupPage.jsx
Learner experiences
- Learning paths
frontend/src/features/path/pages/LearningPathsPage.jsx - Video lessons and quizzes
frontend/src/features/lesson/pages/LessonViewerPage.jsx - Camera landmarks
frontend/src/features/lesson/components/LandmarkCamera.jsx - Vocabulary and saved signs
frontend/src/features/vocabulary/pages/VocabularyPage.jsx - Practice activities
frontend/src/features/practice/pages/PracticePage.jsx - Scenarios and challenges
frontend/src/features/activities/pages/ScenarioActivityPage.jsx - Progress dashboard
frontend/src/features/progress/pages/ProgressPage.jsx
Classroom management
- Instructor workspace
frontend/src/features/instructor/pages/InstructorHomePage.jsx - Classroom membership
frontend/src/features/classroom/pages/LearnerClassroomsPage.jsx
Admin tools
- Content and account admin
frontend/src/features/admin/pages/AdminWorkspace.jsx - Landmark Sign Lab
frontend/src/features/admin/pages/SignLabPage.jsx
API and persistence
- HTTP API client
frontend/src/adapters/http/api.js - Flask API
backend/app.py - PostgreSQL
Other components
- Learner
- Instructor
- Administrator
Connections 32
- Learner → Sign-in and signup: signs in
- Instructor → Sign-in and signup: signs in
- Administrator → Sign-in and signup: signs in
README.md - React app shell → Session restoration: restores session
frontend/src/app/App.jsx - React app shell → Role-based routes: renders routes
frontend/src/app/App.jsx - Role-based routes → Sign-in and signup: routes to
frontend/src/app/routes.jsx - Sign-in and signup → HTTP API client: submits credentials
frontend/src/features/auth/pages/LearnerAuthPage.jsx - Session restoration → HTTP API client: checks session
frontend/src/app/hooks/useSession.js - Learner → Profile onboarding: sets up profile
- Role-based routes → Learning paths: routes to
frontend/src/app/routes.jsx - Role-based routes → Video lessons and quizzes: routes to
frontend/src/app/routes.jsx - Role-based routes → Practice activities: routes to
frontend/src/app/routes.jsx - Role-based routes → Scenarios and challenges: routes to
frontend/src/app/routes.jsx - Role-based routes → Vocabulary and saved signs: routes to
frontend/src/app/routes.jsx - Role-based routes → Progress dashboard: routes to
- Video lessons and quizzes → Camera landmarks: uses camera
frontend/src/features/lesson/pages/LessonViewerPage.jsx - Role-based routes → Instructor workspace: routes to
frontend/src/app/routes.jsx - Role-based routes → Classroom membership: routes to
frontend/src/app/routes.jsx - Role-based routes → Content and account admin: routes to
frontend/src/app/routes.jsx - Role-based routes → Landmark Sign Lab: routes to
frontend/src/app/routes.jsx - Learning paths → HTTP API client: loads content
- Video lessons and quizzes → HTTP API client: loads lessons
- Practice activities → HTTP API client: submits practice
- Scenarios and challenges → HTTP API client: loads activities
- Vocabulary and saved signs → HTTP API client: loads signs
- Progress dashboard → HTTP API client: loads progress
- Instructor workspace → HTTP API client: manages learners
- Classroom membership → HTTP API client: manages membership
- Content and account admin → HTTP API client: manages content
- Landmark Sign Lab → HTTP API client: uses API
- HTTP API client → Flask API: sends requests
- Flask API → PostgreSQL: reads and writes
README.md