Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/CharleeWa/vue3-vant-mobile

An mobile web apps template based on the Vue 3 ecosystem。一个基于 Vue 3 生态系统的移动 web 应用模板，帮助你快速完成业务开发。
https://github.com/CharleeWa/vue3-vant-mobile

h5 mobile setup starter typescript unocss vite-starter vite-template vue3-template vuejs wechat-h5

Last synced: 3 months ago
JSON representation

An mobile web apps template based on the Vue 3 ecosystem。一个基于 Vue 3 生态系统的移动 web 应用模板，帮助你快速完成业务开发。

Awesome Lists containing this project

README 

        



cover



vue3-vant-mobile



English / [简体中文](./README.zh-CN.md)



An mobile web apps template based on the Vue 3 ecosystem.



一个基于 Vue 3 生态系统的移动 web 应用模板，帮助你快速完成业务开发。





license

version

repo-size

languages

issues




[文档](https://easy-temps.github.io/easy-docs/vue3-vant-mobile/) / [交流](https://github.com/easy-temps/vue3-vant-mobile/issues/56) / [反馈](https://github.com/easy-temps/vue3-vant-mobile/issues)



Live Demo



[![Netlify Status](https://api.netlify.com/api/v1/badges/e6828bd2-2904-4c3e-a67c-b97d32aa1275/deploy-status)](https://app.netlify.com/sites/vue3-vant-mobile/deploys)










## Features



- ⚡️ [Vue 3](https://github.com/vuejs/core), [Vite 5](https://github.com/vitejs/vite), [pnpm](https://pnpm.io/), [esbuild](https://github.com/evanw/esbuild) - born with fastness



- 🗂 [File based routing](./src/router)



- 📦 [Components auto importing](./src/components)



- 🍍 [State Management via Pinia](https://pinia.vuejs.org)



- 📲 [PWA](https://github.com/antfu/vite-plugin-pwa)



- 🎨 [UnoCSS](https://github.com/antfu/unocss) - the instant on-demand atomic CSS engine



- 🌍 [I18n ready](./src/locales)



- 🔥 Use the [new `` syntax](https://github.com/vuejs/rfcs/pull/227)



- 📥 [APIs auto importing](https://github.com/antfu/unplugin-auto-import) - use Composition API and others directly



- 💪 TypeScript, of course



- ⚙️ Unit Testing with [Vitest](https://github.com/vitest-dev/vitest)



- 💾 [Mock](https://github.com/pengzhanbo/vite-plugin-mock-dev-server) server Support



- 🌈 Git [hooks](./.husky) - lint and commit



- 🪶 [Vant](https://github.com/youzan/vant) - Vue UI library for mobile web apps



- 🔭 [vConsole](https://github.com/vadxq/vite-plugin-vconsole) - the developer tool for mobile web page



- 📱 Browser adaptation - use viewport vw/vh units



- 💻 [Desktop optimization](https://github.com/wswmsword/postcss-mobile-forever) - the mobile area



- 🌓 Dark Mode Support



- 🛡️ Configure [ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) as default



- ☁️ Deploy on [Netlify](https://www.netlify.com), zero-config



<br>



## Pre-packed



### UI Frameworks



- [UnoCSS](https://github.com/antfu/unocss) - The instant on-demand atomic CSS engine

  - [`@unocss/preset-rem-to-px`](https://github.com/unocss/unocss/tree/main/packages/preset-rem-to-px) - Converts rem to px for all utilities

  - [`eslint-plugin-unocss`](https://github.com/devunt/eslint-plugin-unocss) - ESLint plugin for UnoCSS

- [Vant](https://github.com/youzan/vant) - Vue UI library for mobile web apps

  - [`vant-touch-emulator`](https://github.com/youzan/vant/tree/main/packages/vant-touch-emulator) - Simulate mobile touch events on the desktop

  - [`vant-use`](https://github.com/youzan/vant/tree/main/packages/vant-use) - Built-in composition APIs of Vant



### Plugins



- [Vue Router](https://github.com/vuejs/router)

  - [`unplugin-vue-router`](https://github.com/posva/unplugin-vue-router) - file system based routing

- [Pinia](https://pinia.vuejs.org) - Intuitive, type safe, light and flexible Store for Vue using the composition api

  - [`pinia-plugin-persistedstate`](https://github.com/prazdevs/pinia-plugin-persistedstate) -  Configurable persistence and rehydration of Pinia stores

- [Vue I18n](https://github.com/intlify/vue-i18n-next) - Internationalization

  - [`unplugin-vue-i18n`](https://github.com/intlify/bundle-tools/tree/main/packages/unplugin-vue-i18n) - unplugin for Vue I18n

- [unplugin-vue-components](https://github.com/antfu/unplugin-vue-components) - components auto import

- [unplugin-auto-import](https://github.com/antfu/unplugin-auto-import) - Directly use Vue Composition API and others without importing

- [vite-plugin-vconsole](https://github.com/vadxq/vite-plugin-vconsole) - A lightweight, extendable front-end developer tool for mobile web page

- [vite-plugin-mock-dev-server](https://github.com/pengzhanbo/vite-plugin-mock-dev-server) - Vite Plugin for API mock dev server

- [postcss-mobile-forever](https://github.com/wswmsword/postcss-mobile-forever) - To adapt different displays by one mobile viewport

- [vite-plugin-vue-devtools](https://github.com/vuejs/devtools-next) - Designed to enhance the Vue developer experience

- [vueuse](https://github.com/antfu/vueuse) - collection of useful composition APIs

- [@unhead/vue](https://github.com/unjs/unhead) - manipulate document head reactively

- [vite-plugin-pwa](https://github.com/antfu/vite-plugin-pwa) - PWA

- [vite-plugin-sitemap](https://github.com/jbaubree/vite-plugin-sitemap) - sitemap and robots generator



### Coding Style



- Use Composition API with [`<script setup>` SFC syntax](https://github.com/vuejs/rfcs/pull/227)

- [ESLint](https://eslint.org/) with [@antfu/eslint-config](https://github.com/antfu/eslint-config), single quotes, no semi



### Dev tools



- [TypeScript](https://www.typescriptlang.org/)

- [Vitest](https://github.com/vitest-dev/vitest) - Unit testing powered by Vite

- [pnpm](https://pnpm.js.org/) - fast, disk space efficient package manager

- [Netlify](https://www.netlify.com/) - zero-config deployment

- [VS Code Extensions](./.vscode/extensions.json)

  - [Vite](https://marketplace.visualstudio.com/items?itemName=antfu.vite) - Fire up Vite server automatically

  - [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) - Vue 3 `<script setup>` IDE support

  - [Iconify IntelliSense](https://marketplace.visualstudio.com/items?itemName=antfu.iconify) - Icon inline display and autocomplete

  - [i18n Ally](https://marketplace.visualstudio.com/items?itemName=lokalise.i18n-ally) - All in one i18n support

  - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)



## Try it now



> vue3-vant-mobile requires Node 18+



### GitHub Template



[Create a repo from this template on GitHub](https://github.com/easy-temps/vue3-vant-mobile/generate)



### Clone to local



If you prefer to do it manually with the cleaner git history



```bash

npx tiged easy-temps/vue3-vant-mobile my-mobile-app

cd my-mobile-app

pnpm i # If you don't have pnpm installed, run: npm install -g pnpm

```



## Checklist



When you use this template, try follow the checklist to update your info properly



- [ ] Change the author name in `LICENSE`

- [ ] Change the title in `index.html`

- [ ] Change the hostname in `vite.config.ts`

- [ ] Change the favicon in `public`

- [ ] Clean up the READMEs and remove routes



And, enjoy :)



## Usage



### Development



Just run and visit <http://localhost:3000>



```bash

pnpm dev

```



### Build



To build the App, run



```bash

pnpm build

```



And you will see the generated file in `dist` that ready to be served.



### Deploy on Netlify



Go to [Netlify](https://app.netlify.com/start) and select your clone, `OK` along the way, and your App will be live in a minute.



## Community



We recommend that [issue](https://github.com/easy-temps/vue3-vant-mobile/issues) be used for problem feedback, or Wechat group.



<img style="width: 25%" src="https://cdn.jsdelivr.net/gh/easy-temps/easy-static/community.png" alt="community" />



## Donation ☕



[Buy Me a Coffee](https://github.com/CharleeWa/sponsor)



<h2 align="center">💝 Our Sponsors 💝</h2>



<p align="center">

Your sponsorship will help us continue to iterate on this exciting project! 🚀

</p>



<p align="center">

<a href="https://github.com/keyFeng"><img src="https://avatars.githubusercontent.com/u/52267976?v=4" width="60px" alt="keyFeng" /></a>

<a href="https://github.com/ljt990218"><img src="https://avatars.githubusercontent.com/u/50509815?v=4" width="60px" alt="ljt990218" /></a>

<a href="https://github.com/heked"><img src="https://avatars.githubusercontent.com/u/14127731?v=4" width="60px" alt="heked" /></a>

</p>



<h2 align="center">

💪 Contributors 💪

</h2>



<p align="center">

Our contributors have made this project better. Thank you! 🙏

</p>



<p align="center">

<a href="https://github.com/CharleeWa"><img src="https://avatars.githubusercontent.com/u/22477554?v=4" width="60px" alt="CharleeWa" /></a>

<a href="https://github.com/ljt990218"><img src="https://avatars.githubusercontent.com/u/50509815?v=4" width="60px" alt="ljt990218" /></a>

<a href="https://github.com/wswmsword"><img src="https://avatars.githubusercontent.com/u/26893092?v=4" width="60px" alt="wswmsword" /></a>

<a href="https://github.com/weiq"><img src="https://avatars.githubusercontent.com/u/1697158?v=4" width="60px" alt="weiq" /></a>

<a href="https://github.com/SublimeCT"><img src="https://avatars.githubusercontent.com/u/20380890?v=4" width="60px" alt="SublimeCT" /></a>

<a href="https://github.com/ReginYuan"><img src="https://avatars.githubusercontent.com/u/49477488?v=4" width="60px" alt="ReginYuan" /></a>

<a href="https://github.com/smartsf"><img src="https://avatars.githubusercontent.com/u/19995400?v=4" width="60px" alt="smartsf" /></a>

<a href="https://github.com/Kysen777"><img src="https://avatars.githubusercontent.com/u/63892082?v=4" width="60px" alt="Kysen777" /></a>

<a href="https://github.com/Leezon"><img src="https://avatars.githubusercontent.com/u/38120280?v=4" width="60px" alt="Leezon" /></a>

<a href="https://github.com/AlphaYoung111"><img src="https://avatars.githubusercontent.com/u/54132313?v=4" width="60px" alt="AlphaYoung111" /></a>

<a href="https://github.com/leo4developer"><img src="https://avatars.githubusercontent.com/u/15160478?v=4" width="60px" alt="leo4developer" /></a>

<a href="https://github.com/InsHomePgup"><img src="https://avatars.githubusercontent.com/u/47906083?v=4" width="60px" alt="InsHomePgup" /></a>

<a href="https://github.com/wowping"><img src="https://avatars.githubusercontent.com/u/137802961?v=4" width="60px" alt="wowping" /></a>

<a href="https://github.com/ChunyuPCY"><img src="https://avatars.githubusercontent.com/u/21986942?v=4" width="60px" alt="ChunyuPCY" /></a>

<a href="https://github.com/qiyue2015"><img src="https://avatars.githubusercontent.com/u/11554433?v=4" width="60px" alt="qiyue2015" /></a>

<a href="https://github.com/pyQianYi"><img src="https://avatars.githubusercontent.com/u/57526688?v=4" width="60px" alt="pyQianYi" /></a>

<a href="https://github.com/xyy94813"><img src="https://avatars.githubusercontent.com/u/17971352?v=4" width="60px" alt="xyy94813" /></a>

</p>



## License



[MIT](./LICENSE) License