How govindasaikiran/helix works
HELIX is an adaptive student planner and study platform. Students provide academic work, deadlines, syllabus material, and availability through the app; planning and AI features turn that input into proposed schedules and study materials, while deterministic planning supports schedule repair. The app also provides timetable, project, quiz, analytics, timer, and notification features. The README documents these capabilities, but several feature implementations and their wiring are not included in the sampled source, so those links are left broad or omitted.
Main entry points: App.tsx App Router · aiService.ts AI Service · TopicLearningPage.tsx Topic Learning · pages Planner Pages
Components 28
Student App
- App Router
src/App.tsx - Authentication
src/context/AuthContext.tsx - Planner Pages
src/pages - Study Timers
src/components/shared/FloatingStudyTimer.tsx
Planning and Agent
- Planning Agent Page
src/pages/PlanningAgentPage.tsx - Agent Chat UI
src/components/shared/AgentChatbot.tsx - AI Service
src/services/aiService.ts - Intent Router
src/services/agent/intentRouter.ts - Agent Executor
src/services/agent/agentExecutor.ts - Planner Service
src/services/plannerService.ts - Deterministic Planner
server/planner/deterministicPlanner.ts
Study Intelligence
- Study Hub
src/pages/StudyHubPage.tsx - Topic Learning
src/pages/TopicLearningPage.tsx - Quiz Practice
src/pages/QuizPage.tsx - PDF Text Extraction
src/utils/pdfParser.ts
Academic Data
- Academic Services
src/services/taskService.ts - Plan State
src/context/PlanContext.tsx - Supabase Client
src/lib/supabaseClient.ts
External Services
- Supabase
- API Server
server/index.ts - AI API Route
api/ai/generate.ts - Gemini AI
- YouTube Search
api/youtube/search.ts - YouTube API
- Notification Services
src/services/notificationService.ts - Firebase Messaging
src/services/firebaseMessaging.ts - Firebase Cloud Messaging
Other components
- Student
Connections 26
- Student → App Router: uses
- App Router → Authentication: provides auth
- App Router → Planner Pages: routes to
- App Router → Plan State: provides plan state
- Planner Pages → Study Timers: offers timer
- Student → Agent Chat UI: requests plans
- Agent Chat UI → Planning Agent Page: opens
- Planning Agent Page → AI Service: requests agent work
- AI Service → Agent Executor: executes agent
- Agent Executor → Intent Router: classifies input
- Student → Study Hub: studies
- Study Hub → Topic Learning: opens topics
- Topic Learning → Quiz Practice: practices
- Topic Learning → PDF Text Extraction: extracts material
- AI Service → AI API Route: requests generation
- AI API Route → Gemini AI: generates content
- Student → Planner Service: submits workload
- Planner Service → Deterministic Planner: requests schedule logic
- API Server → Deterministic Planner: builds replan proposal
- Plan State → Academic Services: uses academic data
- Academic Services → Supabase Client: reads and writes
- Supabase Client → Supabase: queries
- Student → YouTube Search: requests lectures
- YouTube Search → YouTube API: searches videos
- Notification Services → Firebase Messaging: uses messaging
- Firebase Messaging → Firebase Cloud Messaging: sends push