{"id":27668,"library":"create-zuplo-api","title":"Create Zuplo API","description":"Create Zuplo API is a zero-dependency CLI tool (v6.69.10, latest) for scaffolding new Zuplo API projects interactively or non-interactively. It supports TypeScript, JavaScript, ESLint, Prettier, multiple package managers (npm, yarn, pnpm, bun), and optional server-side project creation on portal.zuplo.com. Unlike generic scaffolding tools, it is officially maintained by Zuplo and offers offline support, example templates, and git initialization. Requires Node >=20.","status":"active","version":"6.69.10","language":"javascript","source_language":"en","source_url":"https://github.com/zuplo/core","tags":["javascript","api","openapi","zuplo"],"install":[{"cmd":"npm install create-zuplo-api","lang":"bash","label":"npm"},{"cmd":"yarn add create-zuplo-api","lang":"bash","label":"yarn"},{"cmd":"pnpm add create-zuplo-api","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The package is a CLI tool, not a library. Use npx or the equivalent for your package manager.","wrong":"npm install -g create-zuplo-api","symbol":"createZuploApi (npx)","correct":"npx create-zuplo-api@latest"},{"note":"npm's npm create is specifically for scaffolding packages and is the recommended way.","wrong":"npm init zuplo-api","symbol":"npm create","correct":"npm create zuplo-api@latest"},{"note":"yarn create does not require global install.","wrong":"yarn add create-zuplo-api && create-zuplo-api","symbol":"yarn create","correct":"yarn create zuplo-api"}],"quickstart":{"code":"npm create zuplo-api@latest my-api -- --typescript --prettier --eslint","lang":"typescript","description":"Scaffolds a new Zuplo API project named 'my-api' with TypeScript, Prettier, and ESLint in non-interactive mode."},"warnings":[{"fix":"Update Node.js to version 20 or later.","message":"Node >=20 required — older versions will fail to run.","severity":"breaking","affected_versions":">=6.0.0"},{"fix":"Pass --no-server-project or --server-project explicitly to avoid surprises in CI.","message":"The CLI will prompt to create a project on portal.zuplo.com by default in interactive mode; in non-interactive (CI) mode it skips this unless --server-project or --account is passed.","severity":"gotcha","affected_versions":"*"},{"fix":"Use --example <url> --example-path <path> for complex GitHub URLs.","message":"If you pass --example with a GitHub URL containing a slash in the branch name, you must also provide --example-path to disambiguate.","severity":"gotcha","affected_versions":"*"},{"fix":"Use --no-install (available since v6) instead of workarounds.","message":"The --no-install option skips package installation; previously there was no way to skip it.","severity":"deprecated","affected_versions":"<6.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Upgrade Node.js to version 20 or later, or use nvm to switch to a compatible version.","cause":"The package requires Node.js version 20 or higher.","error":"Error: The engine \"node\" is incompatible with this module. Expected version \">=20\". Got \"18.x.x\""},{"fix":"Use npx create-zuplo-api or npm create zuplo-api instead of requiring it in code.","cause":"Attempting to use the package as a library instead of a CLI tool.","error":"Error: Cannot find module 'create-zuplo-api'"},{"fix":"Use npx create-zuplo-api@latest or the npm create command; avoid global install.","cause":"Global install may be missing or not in PATH.","error":"command not found: create-zuplo-api"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}