Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (create-caleb) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
create-caleb
Generate practical-exam style full-stack projects with Express, MySQL, React, and Tailwind CSS.
Usage
npm create caleb@latestYou can also run:
npx create-calebThe 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_2026Inside that folder it generates:
backend-projectfrontend-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.jsonso you can re-prompt later
AI providers
Supported direct providers:
GROQ_API_KEYGEMINI_API_KEYOPENROUTER_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:backendnpm run start:frontendnpm run build:backendnpm run build:frontendnpm 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 runningnpm 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.