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

By audience

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