vant-weapp (youzan/vant-weapp)
Searching Database…
18.5K ·GitHub
What is this?
Vant Weapp is a lightweight, reliable UI component library for WeChat mini programs, open-sourced in 2017 as one of the official flavors of the Vant mobile component family.
Is this the Vue version of Vant, or something different?
This is the WeChat Mini Program build — native mini program custom components, not Vue. Vant officially ships Vue 2, Vue 3 and WeChat versions, while the React and Alipay Mini Program versions are maintained by community teams.
How do I add it to my mini program project?
Install via npm (recommended) or clone the repo and copy the dist directory into your project, then register the components you need in your page's json file and use them directly in wxml.
Do I need to already know WeChat mini program development to use it?
Yes — the README assumes you have already studied WeChat's official Mini Program tutorial and the custom components guide. This is a UI layer on top of the platform, not a starter course.
Any version requirements or gotchas I should know about?
Your mini program must run on base library 2.6.5 or newer. Also, the QR-code demo mini program is not the latest build due to WeChat's review process — clone the repo to preview the newest version in DevTools instead.
How can I try the components before using them in my own project?
Scan the QR code in the README to open the demo mini program, or clone the repo and add the vant-weapp/example directory to WeChat DevTools to preview all examples locally — cloning also gets you the newest version, since the published demo lags behind.
What is the van-area component and does it come with region data?
It is the province/city/district picker. It ships without data out of the box — you initialize it by importing the vant-weapp/example/databasearea.JSON file into your WeChat cloud development environment.
What are similar projects?
coloruicss, vux, weui-wxss, weui, WxJava, vant, react-native-calendars, wepy
Which topics is it in?
miniprogram, weixin, wechat, mobile-development, component-library, ui-components, css, developers, mobile, ui, free, npm