🏠简介
unibest
是一个集成了多种工具和技术的uniapp
开发模板,由uniapp
+Vue3
+Ts
+Vite4
+UnoCss
+uv-ui
+VSCode
构建,模板具有代码提示、自动格式化、统一配置、代码片段等功能,并内置了许多常用的基本组件和基本功能,让你编写uniapp
拥有best
体验。
✨ 特性
-
🔥 最新语法 -
<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 属性
自动排序,增强编码一致性 -
🖥
多环境
配置分开,想则怎么配置就怎么配置
👍 实用功能
- [x] 页面下拉刷新(全局+局部)
- [x] 页面上拉加载
- [x] 导航栏返回 or 去首页
- [x] 导航栏渐变(微信+h5+App)
- [x] 自定义导航栏顶部机型适配
- [x] 微信小程序分享(好友+朋友圈)
- [x] 微信登录
- [ ] 非微信登录(h5 和 App)
- [ ] 微信一键登录(基于手机号)- 需要非个人认证用户
- [x] 微信小程序获取头像昵称+隐私协议
- [x] 微信小程序 vconsole 调试
- [x] 路由拦截
- [x] 多语言模板
- [x] 页面悬浮球(floating bubble)
- [x] 多 tab 列表功能
- [x] 瀑布流
- [x] 大转盘抽奖
- [x] 九宫格抽奖
- [ ] 登陆模板(APP)
- [ ] 登陆模板(H5)
⌛️实践
前置依赖
- Node.js -
>=v18
- pnpm -
>=7.30
(推荐使用8.15
) - 文本编辑器 - 推荐使用 VS Code
- 终端 - 为了运行
uni
命令,Windows 推荐 Git Bash,Linux 和 macOS 推荐 zsh
下载项目
通过 pnpm create unibest <项目名>
命令生成项目模版:
bash
pnpm create unibest <项目名称> # 默认用 base 模板
pnpm create unibest <项目名称> -t <模板名> # 支持自定义模板
支持 -t
参数选择模板,目前已有 3 个模板,分别是 base
、i18n
、demo
。
bash
pnpm create unibest my-unibest -t base # 基础模板
pnpm create unibest my-unibest -t i18n # 多语言模板
pnpm create unibest my-unibest -t demo # 所有demo的模板,包含了i18n
安装依赖
bash
pnpm i