weapp-vite

给小程序现代化的开发体验

中文文档 · 中文 README

weapp-vite brings a modern Vite-style workflow to traditional mini-program development. The monorepo includes the core bundler, runtime packages, templates, IDE helpers, MCP support, and end-to-end examples for building WeChat and related mini-program projects with better DX.

Table of Contents

• Why weapp-vite
• Highlights
• Quick Start
• Workspace Layout
• Key Packages
• Documentation
• Contributing
• Contributors
• Star History
• License

Why weapp-vite

• Use a modern toolchain for mini-program apps instead of legacy-only workflows.
• Start quickly with the official create-weapp-vite scaffolder.
• Build across multiple templates, runtimes, demos, and e2e apps from one workspace.
• Explore AI-friendly tooling such as MCP support, IDE helpers, and packaged skills.

Highlights

• Official scaffolder: create-weapp-vite
• Core bundler/runtime packages under packages/, packages-runtime/, and @weapp-core/
• Ready-to-run demo apps in apps/ and regression fixtures in e2e-apps/
• Documentation site in website/
• Extensive CI, HMR, IDE, and runtime validation scripts powered by pnpm + turbo

Quick Start

Create a new project

pnpm create weapp-vite

You can also use yarn create weapp-vite or npm create weapp-vite@latest.

Work on this monorepo locally

pnpm install
pnpm build:pkgs
pnpm test

Useful follow-up commands:

pnpm build:apps
pnpm build:templates
pnpm build:docs

Workspace Layout

• packages/ and packages-runtime/: core tooling and runtime packages
• @weapp-core/: shared workspace utilities and constants
• apps/: demo and playground applications
• templates/: starter templates used by the scaffolder
• e2e/ and e2e-apps/: CI, runtime, and issue reproduction coverage
• website/: the documentation site
• docs/: architecture notes, plans, and reports
• extensions/: editor and integration extensions

Key Packages

• weapp-vite: the main mini-program bundler
• create-weapp-vite: official project scaffolder
• @weapp-vite/mcp: MCP-related tooling
• weapp-ide-cli: CLI helpers for WeChat DevTools workflows
• rolldown-require: helper for bundling and requiring files with Rolldown

Documentation

• Main docs: https://vite.icebreaker.top
• Contributing guide: CONTRIBUTING.md
• Chinese README: README_CN.md

Contributing

Contributions are welcome.

• Open an issue for bugs, feature ideas, or documentation gaps.
• Send a PR for fixes, refactors, docs, or new examples.
• Share production use cases, middleware, and ecosystem integrations.

For contribution details, see CONTRIBUTING.md.

Contributors

Thanks to all contributors.

Star History

License

Distributed under the MIT License. See LICENSE for more information.