{"id":21081,"library":"create-weapp-vite","title":"create-weapp-vite","description":"Official scaffolding tool for weapp-vite, a Vite-based build tool for WeChat Mini Programs. Current stable version 2.3.10. Actively maintained with weekly releases. Key differentiator: provides multiple templates (Wevu, TDesign, Tailwindcss, Vant) and a programmable API for CI/CD, automatically aligning weapp-vite and wevu versions. Requires Node.js ^20.19.0 || >=22.12.0.","status":"active","version":"2.3.10","language":"javascript","source_language":"en","source_url":"https://github.com/weapp-vite/weapp-vite","tags":["javascript","weapp-vite","vite","weapp","typescript"],"install":[{"cmd":"npm install create-weapp-vite","lang":"bash","label":"npm"},{"cmd":"yarn add create-weapp-vite","lang":"bash","label":"yarn"},{"cmd":"pnpm add create-weapp-vite","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only; CommonJS require will fail.","wrong":"const { createProject } = require('create-weapp-vite')","symbol":"createProject","correct":"import { createProject } from 'create-weapp-vite'"},{"note":"TemplateName is a named export, not default.","wrong":"import TemplateName from 'create-weapp-vite'","symbol":"TemplateName","correct":"import { TemplateName } from 'create-weapp-vite'"},{"note":"No default export; use named import.","wrong":"import createProject from 'create-weapp-vite'","symbol":"default (createProject)","correct":"import { createProject } from 'create-weapp-vite'"}],"quickstart":{"code":"import { createProject, TemplateName } from 'create-weapp-vite'\n\nasync function main() {\n  await createProject('my-miniapp', TemplateName.wevu)\n  console.log('Project created!')\n}\n\nmain().catch(console.error)","lang":"typescript","description":"Creates a new WeChat Mini Program project using the 'wevu' template via the programmatic API."},"warnings":[{"fix":"Update Node.js to 20.19.0+ or 22.12.0+ using nvm or your package manager.","message":"Requires Node.js version ^20.19.0 or >=22.12.0. Older Node.js versions will fail at runtime.","severity":"breaking","affected_versions":">=2.3.0"},{"fix":"Ensure your project uses ESM (\"type\": \"module\" in package.json) or use dynamic import() if needed.","message":"The package is ESM-only since v2. Using CommonJS require() throws a runtime error.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Change `import createProject from 'create-weapp-vite'` to `import { createProject } from 'create-weapp-vite'`.","message":"The default export createProject was removed in v2. Use named export createProject instead.","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"Use the TemplateName enum or exact lowercase string: 'default', 'wevu', 'wevu-tdesign', 'tailwindcss', 'tdesign', 'vant', 'plugin', 'lib'.","message":"Template names are case-sensitive. Using incorrect casing (e.g., 'Wevu' vs 'wevu') will throw an error.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Always supply a project name when using non-interactive mode, e.g., `pnpm create weapp-vite my-app wevu`.","message":"When using the CLI non-interactively, the project name must be provided as the first positional argument; omitting it will default to interactive mode.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Upgrade Node.js to >=20.19.0 and change to ESM (\"type\": \"module\" in package.json) or use `await import('create-weapp-vite')`.","cause":"Using require() on an ESM-only package with Node.js < 20.19.0 or in a CJS project.","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module /path/to/create-weapp-vite/index.mjs not supported."},{"fix":"Use one of the supported template names: default, wevu, wevu-tdesign, tailwindcss, tdesign, vant, plugin, lib.","cause":"Specifying a template name that does not exist or is misspelled.","error":"Template 'my-custom-template' not found. Available templates: default, wevu, wevu-tdesign, tailwindcss, tdesign, vant, plugin, lib"},{"fix":"Pass a non-empty string as the first argument to createProject(), e.g., createProject('my-app', TemplateName.default).","cause":"Calling createProject() without a project name or with an undefined argument.","error":"The \"path\" argument must be of type string. Received undefined"},{"fix":"Run `pnpm add create-weapp-vite` or `npm install create-weapp-vite` before importing.","cause":"The package is not installed. When using pnpm create, it fetches the package on the fly, but if you try to import it directly without installing, it fails.","error":"Cannot find package 'create-weapp-vite'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}