How n-avtej/algo-visualizer works
AlgoLens Pro is an interactive algorithm-learning suite. Learners explore the curriculum, run algorithms to see stepwise visualizations and telemetry, practice with quizzes, and can ask an AI tutor questions. The graph shows the documented frontend-to-API workflow, curriculum and progress features, and the backend algorithm and AI capabilities. Some backend route-to-implementation links are documented only at a broad level, so those links are marked unverified rather than asserting specific calls.
Main entry points: client.ts API client · App.tsx Web app routes · visualizations Module visualizers · rag.py RAG pipeline
Components 23
Learning experience
- Web app routes
frontend/src/App.tsx - Curriculum home
frontend/src/pages/HomePage.tsx - Curriculum content
frontend/src/data/curriculumData.ts - Practice quizzes
frontend/src/pages/PracticePage.tsx - Progress state
frontend/src/store/progressStore.ts - Module learning
frontend/src/pages/ModulePage.tsx - AI tutor page
frontend/src/pages/AIAssistantPage.tsx
Algorithm visualizations
- Module visualizers
frontend/src/components/visualizations - Animation player
frontend/src/components/common/AnimationPlayer.tsx - Metrics and code
frontend/src/components/common/MetricsPanel.tsx
API and algorithms
- API client
frontend/src/api/client.ts - FastAPI entrypoint
backend/app/main.py - REST route handlers
backend/app/api/routes - Algorithm traces
backend/app/api/routes/algorithms.py - Algorithm implementations
backend/app/algorithms - Authentication
backend/app/api/routes/auth.py - AI endpoint
backend/app/api/routes/ai.py
AI and persistence
- RAG pipeline
backend/app/ai/rag.py - Embedding service
backend/app/ai/embeddings.py - Knowledge base
backend/app/models/knowledge_base.py - Application database
backend/app/db/session.py
Other components
- Learner
- Gemini AI
Connections 22
- Learner → Web app routes: navigates
frontend/src/App.tsx - Web app routes → Curriculum home: routes to
frontend/src/App.tsx - Web app routes → Module learning: routes to
frontend/src/App.tsx - Web app routes → Practice quizzes: routes to
frontend/src/App.tsx - Curriculum home → Curriculum content: loads content
frontend/src/pages/HomePage.tsx - Curriculum home → Progress state: reads progress
frontend/src/pages/HomePage.tsx - Module learning → Module visualizers: presents stages
README.md - Module visualizers → Animation player: uses playback
README.md - Module visualizers → Metrics and code: shows metrics
README.md - Module visualizers → API client: requests traces
frontend/src/components/visualizations/Module1/ComparisonArena.tsx - API client → FastAPI entrypoint: sends requests
frontend/src/api/client.ts - FastAPI entrypoint → REST route handlers: mounts routes
backend/app/main.py - REST route handlers → Algorithm traces: dispatches runs
- Algorithm traces → Algorithm implementations: generates traces
- API client → Authentication: calls auth endpoints
frontend/src/api/client.ts - AI tutor page → API client: submits questions
README.md - API client → AI endpoint: calls AI endpoint
frontend/src/api/client.ts - AI endpoint → RAG pipeline: uses retrieval
README.md - RAG pipeline → Knowledge base: retrieves chunks
backend/app/ai/rag.py - RAG pipeline → Gemini AI: requests completion
backend/app/ai/rag.py - RAG pipeline → Application database: queries vectors
backend/app/ai/rag.py - Embedding service → Gemini AI: creates vectors
backend/app/ai/embeddings.py