create-caleb

Generate practical-exam style full-stack projects with Express, MySQL, React, and Tailwind CSS.

Usage

npm create caleb@latest

You can also run:

npx create-caleb

The CLI now asks for:

• the student's full name
• the exam year
• the practical scenario prompt
• optional scenario-reference folders

It creates the root folder in this format:

full_name_national_practical_exam_2026

Inside that folder it generates:

• backend-project
• frontend-project

What it does

• generates a session-auth full-stack app that matches the prompt closely
• references up to 10 previous scenario projects to stay aligned with practical-exam patterns
• falls back to Puter in the browser when API keys are missing or fail
• writes backend and frontend env files automatically
• can detect XAMPP, try to start Apache and MySQL, and repair busy default ports
• installs dependencies
• verifies the generated backend and frontend
• attempts an automatic AI repair loop when verification fails
• saves project memory in .caleb/session.json so you can re-prompt later

AI providers

Supported direct providers:

• GROQ_API_KEY
• GEMINI_API_KEY
• OPENROUTER_API_KEY

If none are available, create-caleb can open a local Puter bridge page in the browser. If Puter asks the user to log in or approve access, they can accept once and continue.

Re-prompt existing projects

After a project is generated you can continue from the current codebase:

npx create-caleb --continue .

That mode reads .caleb/session.json, loads the current backend and frontend source files, and asks what should change next.

Root scripts in generated projects

• npm run start:backend
• npm run start:frontend
• npm run build:backend
• npm run build:frontend
• npm run verify

The generated root project does not use concurrently.

Flags

npm create caleb@latest -- --skip-install
npm create caleb@latest -- --continue .
npm create caleb@latest -- --scenario-root C:\Users\kwize\practical-exam

• --skip-install: generate files without running npm install
• --continue PATH: re-prompt and update an existing generated project
• --scenario-root PATH: add a folder containing past scenario projects
• --help: show usage

Notes

• The generator targets Node.js 18+.
• Generated apps assume MySQL and common practical-exam CRUD/report flows unless the prompt says otherwise.
• Puter fallback uses a browser flow because Puter is frontend-oriented.