Getting started (vibe coding)¶

1. Install Node.js¶

Download Node.js 18 LTS or newer from nodejs.org for dev, build, and SCORM export.

Check in a terminal:

node -v
npm -v

You should see v18.x or v20.x.

2. Create a course project¶

Open a folder where you want the project (e.g. Documents/courses). In the terminal:

npx @lessonkit/cli init my-phishing-course
cd my-phishing-course

lessonkit init copies a starter template, writes lessonkit.json, and installs dependencies.

3. Open the project in your AI editor¶

Cursor / VS Code: File → Open Folder → select my-phishing-course
Tell the AI: “This is a LessonKit course. Read lessonkit.json and src/App.tsx before suggesting edits.”

4. Preview locally¶

npm run dev

(npx lessonkit dev works the same way.) Open the URL shown (usually http://localhost:5173). Leave this running while you edit.

5. First prompt to try¶

Paste into your AI chat:

I am building a LessonKit course (React + lessonkit.json).
Read lessonkit.json and src/App.tsx.
Change the course title to "Phishing Awareness 101" and add one short paragraph
in the first lesson scenario about spotting suspicious sender addresses.
Do not change courseId, lessonId, or checkId values without updating lessonkit.json.

Save files, check the browser, then continue to Your first course.

Optional: install the CLI globally¶

npm install -g @lessonkit/cli
npm run dev

Global install is optional; npx @lessonkit/cli always works.