How zyrus-47/grokked works
Grokked is a guided coding-learning platform: a student describes an app, reviews and edits an AI-generated curriculum, then works through incremental code and explanations. Each step ends in a five-question comprehension gate; passing unlocks the next step, while grading updates concept mastery. Completion leads to a runnable showcase and mastery report. The README documents the verifier’s independent checking, spaced repetition, sandbox and ZIP export. API-to-agent and API-to-validation links are supported by indexed imports; UI request wiring is described by the README rather than shown in the sampled page excerpts.
Main entry points: build-step/route.ts Step builder · gemini.ts Gemini service · plan/route.ts Curriculum planner · explain/route.ts Step explainer
Components 22
Learning journey
- App prompt
app/page.tsx - Editable plan
app/plan/page.tsx - Code workspace
components/CodePane.tsx - Agent activity
components/AgentFeed.tsx - Quiz gate
components/QuizCard.tsx
Learning agents
- Curriculum planner
app/api/plan/route.ts - Step builder
app/api/build-step/route.ts - Step explainer
app/api/explain/route.ts - Quiz generator
app/api/quiz/route.ts - Quiz verifier
app/api/verify/route.ts - Mastery grader
app/api/grade/route.ts
Agent runtime
- Gemini service
lib/gemini.ts - Agent instructions
lib/agent-prompts.ts - Output validation
lib/zod-schemas.ts - Offline demo content
data/demo/todo-app.ts
Progress and results
- Learning state
lib/store.ts - Completion page
app/report/page.tsx - Mastery and showcase
components/MasteryReport.tsx - Sandboxed app preview
components/MasteryReport.tsx - ZIP export
components/MasteryReport.tsx
Other components
- Student
- Google Gemini
Connections 40
- Student → App prompt: describes app
README.md - App prompt → Curriculum planner: requests plan
README.md - Curriculum planner → Editable plan: returns plan
README.md - Editable plan → Step builder: requests step
README.md - Step builder → Code workspace: provides code
README.md - Step builder → Step explainer: builds step context
README.md - Step explainer → Code workspace: provides explanations
README.md - Code workspace → Quiz generator: requests questions
README.md - Quiz generator → Quiz verifier: submits quiz
README.md - Quiz verifier → Quiz gate: returns verified quiz
README.md - Quiz gate → Mastery grader: submits answers
README.md - Mastery grader → Learning state: updates mastery
README.md - Learning state → Editable plan: unlocks next step
lib/store.ts - Learning state → Completion page: provides progress
app/report/page.tsx - Completion page → Mastery and showcase: renders report
app/report/page.tsx - Mastery and showcase → Sandboxed app preview: previews app
README.md - Mastery and showcase → ZIP export: exports bundle
README.md - Curriculum planner → Gemini service: calls model
app/api/plan/route.ts - Step builder → Gemini service: calls model
app/api/build-step/route.ts - Step explainer → Gemini service: calls model
app/api/explain/route.ts - Quiz generator → Gemini service: calls model
app/api/quiz/route.ts - Quiz verifier → Gemini service: calls model
app/api/verify/route.ts - Mastery grader → Gemini service: calls model
app/api/grade/route.ts - Gemini service → Google Gemini: uses SDK
lib/gemini.ts - Curriculum planner → Agent instructions: uses instructions
app/api/plan/route.ts - Step builder → Agent instructions: uses instructions
app/api/build-step/route.ts - Step explainer → Agent instructions: uses instructions
app/api/explain/route.ts - Quiz generator → Agent instructions: uses instructions
app/api/quiz/route.ts - Quiz verifier → Agent instructions: uses instructions
app/api/verify/route.ts - Mastery grader → Agent instructions: uses instructions
app/api/grade/route.ts - Curriculum planner → Output validation: validates output
app/api/plan/route.ts - Step builder → Output validation: validates output
app/api/build-step/route.ts - Step explainer → Output validation: validates output
app/api/explain/route.ts - Quiz generator → Output validation: validates output
app/api/quiz/route.ts - Quiz verifier → Output validation: validates output
app/api/verify/route.ts - Mastery grader → Output validation: validates output
app/api/grade/route.ts - Curriculum planner → Offline demo content: loads demo plan
app/api/plan/route.ts - Step builder → Offline demo content: loads demo step
app/api/build-step/route.ts - Step explainer → Offline demo content: loads demo summary
app/api/explain/route.ts - Quiz generator → Offline demo content: loads demo quiz
app/api/quiz/route.ts