Troubleshooting¶

Single entry point for common LessonKit issues. Pick your path below—detailed runbooks live on the linked pages.

Quick decision tree¶

If you see…	Start here
`npx @lessonkit/cli init` fails or Vite errors on Node 18	Node version errors · Prerequisites
`lessonkit: command not found`	CLI not found
`npm install` fails during `init`	npm install failures
SCORM zip not where expected	FAQ — SCORM path
`lessonkit package` ID / manifest errors	ID parity
Blank page or throw after LMS upload	Production build throws
LMS shows no completion/score	SCORM runs but no completion
Analytics/xAPI 401, 403, or CORS	CORS and proxy errors
AI edits broke the course / blank dev page	Vibe coding troubleshooting
Quiz won’t complete after AI edit	Vibe coding — quiz

Audience	Guide
React developers	Troubleshooting (React developers) — packaging, production builds, LMS delivery, observability
Vibe coding / AI-assisted	Troubleshooting (vibe coding) — symptom table, AI prompts, links to React runbooks
Everyone	FAQ — quick answers on adoption, Node versions, H5P comparison, tracking defaults