{"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,"search_vec":"'2.3.10':25 '20.19.0':56 '22.12.0':57 'activ':26 'align':47 'api':43 'automat':46 'base':15 'build':16 'ci/cd':45 'creat':2 'create-weapp-vit':1 'current':22 'differenti':32 'javascript':58 'key':31 'maintain':27 'mini':20 'multipl':34 'node.js':55 'offici':5 'program':21 'programm':42 'provid':33 'releas':30 'requir':54 'scaffold':6 'stabl':23 'tailwindcss':38 'tdesign':37 'templat':35 'tool':7,17 'typescript':64 'vant':39 'version':24,53 'vite':4,11,14,50,61,62 'vite-bas':13 'weapp':3,10,49,60,63 'weapp-vit':9,48,59 'wechat':19 'week':29 'wevu':36,52","created_at":"2026-04-27T16:57:59.957756+00:00","updated_at":"2026-04-27T16:57:59.957756+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"create-weapp-vite","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/weapp-vite/weapp-vite","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/create-weapp-vite","openapi_spec":null,"status_page":null,"smithery":null,"categories":["web-framework","devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-17","next_check":"2026-07-26","install_tag":null}}