react-workshop-cli

Socratic mentor CLI for the React Fundamentals course, powered by CodeMie + Claude.

The agent knows the full course content and test expectations but guides students with questions, not answers.

Student setup

# 1. Clone the template
git clone <template-repo-url> my-react-app
cd my-react-app

# 2. Install the workshop CLI
npm install -g react-workshop-cli   # once codemie installs claude

# 3. Start a module session
react-workshop start --module 1

On first run it will walk you through CodeMie setup (EPAM SSO login).

Slash commands during the session

| Command | What it does | |----------|-------------| | /hint | One targeted hint — a question, not code | | /check | Reviews your src/ against task criteria | | /step | Suggests the single most logical next step |

Course coordinator — updating content

When coursebook or test files change, re-sync and rebuild:

# Repos must be siblings of this directory:
#   ../react-fundamentals-coursebook
#   ../react-fundamentals-app-tests

npm run sync-content   # copies from sibling repos into src/content/
npm run build          # compiles TS + copies content into dist/

Then publish the new version of the package.