How sam-bot-dev/path-finder works
LearnPath AI guides a learner from topic discovery through a five-question diagnostic, then creates an adaptive learning path with lessons, practice, progress tracking, and saved resources. Curated topic data is always available; optional AI generates diagnostics and modules, while optional YouTube search enriches lessons. Store state persists locally and can synchronize through Firebase. The README is only the Vite template, so this map relies primarily on sampled source and the route tree; some page-to-service calls are inferred from the exposed workflow.
Components 25
Learning Experience
- Application Router
src/App.tsx - App Shell
src/components/Shell.tsx - Topic Browser
src/components/TopicBrowser.tsx - Topic Page
src/pages/TopicPage.tsx - Diagnostic Check-in
src/pages/Diagnostic.tsx - Path Results
src/pages/Results.tsx - Learning Path
src/pages/LearningPath.tsx - Practice Session
src/pages/Practice.tsx - Progress Dashboard
src/pages/Progress.tsx - Saved Resources
src/pages/Saved.tsx - Account Settings
src/pages/Settings.tsx
Learning Engine
- Learning Service
src/lib/services.ts - Topic Curriculum
src/data/topics.ts - Content Validation
src/lib/services.ts - Video Service
src/lib/services.ts
Progress State
- Application Store
src/lib/store.tsx - Browser Storage
External Integrations
- Firebase Client
src/lib/firebase.ts - AI API Handler
api/ai.ts - Video API Handler
api/videos.ts - Service Status API
api/status.ts
Other components
- Learner
- OpenAI
- YouTube
- Firebase
Connections 37
- Learner → Topic Browser: chooses topic
- Learner → Diagnostic Check-in: starts check-in
- Application Router → App Shell: wraps routes
- Application Router → Topic Browser: routes topics
- Application Router → Topic Page: routes topic
- Application Router → Diagnostic Check-in: routes diagnostic
- Application Router → Path Results: routes results
- Application Router → Learning Path: routes path
- Application Router → Practice Session: routes practice
- Application Router → Progress Dashboard: routes progress
- Application Router → Saved Resources: routes saved
- Application Router → Account Settings: routes settings
- Topic Browser → Topic Curriculum: reads topics
- Topic Page → Topic Curriculum: reads topic
- Topic Page → Diagnostic Check-in: starts check-in
- Diagnostic Check-in → Learning Service: requests assessment
- Learning Service → Service Status API: checks services
- Learning Service → AI API Handler: generates content
- AI API Handler → OpenAI: calls model
- Learning Service → Topic Curriculum: uses fallback
- Learning Service → Content Validation: validates content
- Diagnostic Check-in → Path Results: shows score
- Path Results → Learning Service: builds path
- Path Results → Learning Path: opens path
- Learning Path → Application Store: reads progress
- Learning Path → Application Store: records reading
- Learning Path → Video Service: searches resources
- Video Service → Video API Handler: requests videos
- Video API Handler → YouTube: searches videos
- Practice Session → Application Store: records practice
- Progress Dashboard → Application Store: reads activities
- Saved Resources → Application Store: manages saves
- Account Settings → Application Store: updates profile
- App Shell → Application Store: reads session
- Application Store → Browser Storage: persists locally
- Application Store → Firebase Client: syncs cloud
- Firebase Client → Firebase: reads and writes