How subhashdoc234xyz/cognifix works
CogniFix is an adaptive STEM tutoring web application. A learner practices or uploads marked work; the backend diagnoses misconceptions and generates targeted remediation, while the app presents mastery and follow-up study tools. The README documents the agent and integration architecture, but the backend source was not excerpted, so backend relationships below cite that documentation rather than implying its internals were inspected.
Main entry points: App.tsx View orchestration · server.ts Misconception diagnosis · DashboardView.tsx Learning dashboard · main.tsx React application
Components 21
Application entry
- React application
src/main.tsx - View orchestration
src/App.tsx - Landing page
src/components/LandingView.tsx - Google sign-in
src/components/AuthModal.tsx
Learner study tools
- Learning dashboard
src/components/DashboardView.tsx - Practice and diagnosis
src/components/PracticeQuizView.tsx - Spaced flashcards
src/components/FlashcardsView.tsx - Knowledge mind map
src/components/MindMapView.tsx - Skill roadmaps
src/components/RoadmapView.tsx - Teacher analytics
src/components/TeacherPortalView.tsx
Learning services
- Misconception diagnosis
server.ts - Remediation generation
server.ts - Socratic explanations
server.ts - Roadmap generation
server.ts - Document analysis
server.ts
Identity and data
- Google OAuth
- LLM providers
- DuckDuckGo search
- Supabase storage and database
- Initial learning data
src/data/initialData.ts
Other components
- Student or teacher
Connections 27
- Student or teacher → React application: uses
README.md - React application → View orchestration: renders
src/main.tsx - View orchestration → Landing page: selects view
src/App.tsx - View orchestration → Google sign-in: opens sign-in
src/App.tsx - Google sign-in → Google OAuth: redirects to
src/components/AuthModal.tsx - View orchestration → Learning dashboard: selects view
src/App.tsx - View orchestration → Practice and diagnosis: selects view
src/App.tsx - View orchestration → Spaced flashcards: selects view
src/App.tsx - View orchestration → Knowledge mind map: selects view
src/App.tsx - View orchestration → Skill roadmaps: selects view
src/App.tsx - View orchestration → Teacher analytics: selects view
src/App.tsx - View orchestration → Initial learning data: initializes state
src/App.tsx - Learning dashboard → Misconception diagnosis: requests upload diagnosis
src/components/DashboardView.tsx - Practice and diagnosis → Misconception diagnosis: submits thought trace
README.md - Misconception diagnosis → Remediation generation: flags trap for
README.md - Remediation generation → Socratic explanations: supports remediation
README.md - Misconception diagnosis → LLM providers: uses models
README.md - Remediation generation → LLM providers: uses models
README.md - Socratic explanations → LLM providers: uses models
README.md - Skill roadmaps → Roadmap generation: requests roadmap
README.md - Roadmap generation → DuckDuckGo search: grounds resources
README.md - Learning dashboard → Document analysis: uploads work for
README.md - Document analysis → LLM providers: analyzes with vision
README.md - Misconception diagnosis → Supabase storage and database: persists learning data
README.md - Document analysis → Supabase storage and database: stores uploads
README.md - Teacher analytics → Supabase storage and database: uses class data
README.md - View orchestration → Supabase storage and database: uses sessions and data
README.md