README.md

unibest - 最好的 uniapp 开发模板

unibest —— 最好的 uniapp 开发模板，由 uniapp + Vue3 + Ts + Vite5 + UnoCss + wot-ui + z-paging 构成，使用了最新的前端技术栈，无需依靠 HBuilderX，通过命令行方式运行 web、小程序 和 App（编辑器推荐 VSCode，可选 webstorm）。

unibest 内置了 约定式路由、layout布局、请求封装、请求拦截、登录拦截、UnoCSS、i18n多语言 等基础功能，提供了 代码提示、自动格式化、统一配置、代码片段 等辅助功能，让你编写 uniapp 拥有 best 体验 （ unibest 的由来）。

📱 DEMO 地址 | 📖 文档地址

✨ 特性

• ⚡️ Vue 3, Vite, pnpm, esbuild - 就是快！

• 🔥 最新语法 - <script lang="ts" setup> 语法

• 🎨 UnoCSS - 高性能且极具灵活性的即时原子化 CSS 引擎

• 😃 UnoCSS Icons & icones - 海量图标供你选择

• 🍍 pinia & pinia-plugin-persistedstate - 全端适配的全局数据管理

• 🗂 uni.request 请求封装 - 一键引入，快捷使用

• 📦 组件自动化加载 - 可配置化的组件加载方式，轻松加载组件

• 📥 API 自动加载 - 直接使用 Composition API 无需引入

• 🎉 v3 Code Snippets 加快你的页面生成

• 🦾 TypeScript & ESLint & stylelint - 保证代码质量

• 🌈 husky & lint-staged + commitlint - 保证代码提交质量

• 💡 ES6 import 自动排序，css 属性 自动排序，增强编码一致性

• 🖥 多环境 配置分开，想则怎么配置就怎么配置

👍 业务功能

• 页面下拉刷新（全局+局部）
• 页面上拉加载
• 导航栏返回 or 去首页
• 导航栏渐变（微信+h5+App)
• 自定义导航栏顶部机型适配
• 微信小程序分享（好友+朋友圈）
• 微信登录
• 非微信登录（h5 和 App)
• 微信一键登录（基于手机号）- 需要非个人认证用户
• 微信小程序获取头像昵称+隐私协议
• 微信小程序 vconsole 调试
• 多语言模板
• 页面悬浮球(floating bubble)
• 多 tab 列表功能
• 瀑布流
• 路由拦截
• 大转盘抽奖
• 九宫格抽奖

⚙️ 环境

• node>=18
• pnpm>=7.30

📂 快速开始

创建项目

pnpm create unibest my-project

安装、运行

pnpm i
pnpm dev
# dev默认运行的是h5，其他平台执行dev:<uni-platform>，如:
pnpm dev:mp-weixin

pnpm dev 之后在浏览器打开 http://localhost:9000/。

更多模板请看官方文档unibest。

第一次 commit

git add .
git commit -m "feat: init project"

v3 代码块

在 vue 文件中，输入 v3 按 tab 即可快速生成页面模板，可以大大加快页面生成。

原理：基于 VSCode 代码块生成。

📄 License

MIT

Copyright (c) 2024 菲鸽

📊 Github Star History

与其他几个同行库的对比

贡献者

由仓库直接生成：

💓 捐赠鼓励

开源不易，如果 unibest 对你有些帮助，可以请作者吃块糖果 ，算是对开源做出的一点点鼓励吧！