How kadhiravan-k/learnup works
LearnUp is a personal learning platform: users authenticate, import YouTube videos or playlists into a private library, and study them with ordered playback. Its broader product includes calendar planning, focus sessions, notes, roadmaps, analytics, AI assistance, rewards, skills, and connector sync. The map combines documented capabilities with sampled import, authentication, focus, calendar, and MCP code; several feature paths are present in the tree but their implementation details were not sampled.
Main entry points: mcp/route.ts MCP interface · import-service.ts YouTube import · learning-items/route.ts Import endpoint · repository.ts Learning item repository
Components 28
Identity & app shell
- Login and signup
app/(auth)/login/page.tsx - Session authentication
lib/auth/index.ts - Protected app shell
app/(app)/layout.tsx
Library & playback
- Personal library
app/(app)/library/page.tsx - Import endpoint
app/api/learning-items/route.ts - YouTube import
lib/services/import-service.ts - YouTube metadata
lib/youtube/client.ts - Library operations
lib/services/library-service.ts - Playlist player
components/player/YouTubePlayer.tsx
Study workflows
- Calendar planning
app/(app)/calendar/page.tsx - Calendar logic
lib/services/calendar-service.ts - Focus sessions
app/(app)/focus/page.tsx - Focus timer widget
components/dashboard/FocusEngineWidget.tsx - Focus timer state
lib/hooks/useFocusTimer.ts - Notes
app/(app)/notes/page.tsx
Insights & planning
- Learning roadmaps
app/(app)/roadmaps/page.tsx - Learning analytics
app/(app)/analytics/page.tsx - AI assistant
app/(app)/assistant/page.tsx - Rewards
app/(app)/rewards/page.tsx - Skills
app/(app)/skills/page.tsx
Data & integrations
- Learning item repository
lib/db/repository.ts - Calendar repository
lib/db/calendar-repository.ts - Notes repository
lib/db/notes-repository.ts - MCP interface
app/api/mcp/route.ts - Connector dispatch
lib/connectors/index.ts - Supabase PostgreSQL
Other components
- Learner
- YouTube Data API
Connections 23
- Learner → Login and signup: signs in
README.md - Login and signup → Session authentication: authenticates
- Learner → Protected app shell: uses
- Import endpoint → Session authentication: requires auth
app/api/learning-items/route.ts - Import endpoint → YouTube import: imports URL
app/api/learning-items/route.ts - YouTube import → YouTube metadata: fetches metadata
lib/services/import-service.ts - YouTube metadata → YouTube Data API: requests metadata
README.md - YouTube import → Learning item repository: saves items
lib/services/import-service.ts - Personal library → Import endpoint: imports items
- Personal library → Playlist player: opens playback
README.md - Playlist player → YouTube Data API: embeds video
README.md - Calendar planning → Calendar logic: uses calendar logic
app/(app)/calendar/page.tsx - Calendar logic → Calendar repository: persists calendar data
- Focus timer widget → Focus timer state: reads timer state
components/dashboard/FocusEngineWidget.tsx - Focus sessions → Focus timer state: uses timer
- MCP interface → Session authentication: requires auth
app/api/mcp/route.ts - MCP interface → Learning item repository: reads courses
app/api/mcp/route.ts - MCP interface → Notes repository: reads notes
app/api/mcp/route.ts - MCP interface → Connector dispatch: dispatches sync
app/api/mcp/route.ts - Connector dispatch → Learner: syncs study data
- Learning item repository → Supabase PostgreSQL: reads and writes
- Calendar repository → Supabase PostgreSQL: reads and writes
- Notes repository → Supabase PostgreSQL: reads and writes