更新记录

0.0.2(2024-03-12)

更新了全局loading和下拉刷新

0.0.1(2023-07-27)

更新了 husky 代码提交钩子 和 一些eslint , stykelint,commitlint


平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.7.7 app-vue × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
×

uni-app Vue3 Vite4 pinia2 TypeScript 基础框架

简介

  • uni-app Vue3 Vite4 pinia2 TypeScript Tailwindcss 基础框架
  • cli 创建的 Vue3/Vite 项目 与 使用 HBuilderX 导入插件 的包有差异,最好使用vscode开发,请直接访问 开源地址

说明

  • 框架完全基于 Vue3 <script setup> 写法,不支持 Vue2;
  • 可用于学习与交流;
  • 目前测试 H5、微信小程序,APP(Android)通过;
  • 其他平台暂未测试,后续会增加;
  • 如发现问题或建议可在评论区留言, 看到会及时处理;
  • 如有需求亦可在评论区留言,或在此项目基础上增加;
  • 代码规范 husky、prettier、eslint、lint-staged、stylelint 的作用和使用

特性

  • 最新技术栈:使用 Vue3/Vite4/pinia ,TypeScript 等前端前沿技术开发;
  • vue3组件库: wot-design-uni 组件库,wot-design-uni组件库基于vue3+Typescript构建,参照wot desing的设计规范进行开发,旨在给开发者提供统一的UI交互,同时提高研发的开发效率。
  • Tailwind CSS: Tailwind CSS 是一个功能类优先的 CSS 框架,它集成了诸如 flex, pt-4, text-center 和 rotate-90 这样的的类,它们能直接在脚本标记语言中组合起来,构建出任何设计。
  • Eslint/Prettier/stylelint: 规范代码样式格式,统一编码;
  • husky: 提交代码钩子
  • 路由拦截: uni-mini-router 类似Vue Router的API和功能,在uni-app中进行路由跳转、传参、拦截等常用操作;
  • 请求拦截: luch-request 是一个基于Promise 开发的uni-app跨平台、项目级别的请求库,它有更小的体积,易用的api,方便简单的自定义能力。

目录结构


├─ src
│ ├─api # 接口文件目录
│ ├─static # 静态公共文件
│ │ ├─ images # 图片
│ │ │ ├─.png
│ │ │ └─...
│ │ │
│ │ └─ ...
│ │
│ ├─components # 组件目录
│ ├─enum # 枚举
│ ├─pages # 页面
│ │ ├─ index
│ │ │ └─index.vue
│ │ └─...
│ │
│ ├─style # 样式
│ │
│ ├─state # 状态管理模式(pinia)
│ │ ├─ modules # 数据模块
│ │ │ ├─auth.ts
│ │ │ └─...
│ │ │
│ │ └─ index.ts
│ │
│ └─utils # 工具类
│ ├─ cache # 缓存相关目录
│ └─ request.ts #api请求拦截
│ └─ layout #公共的方法
├─ .env
├─ .env.development
├─ .env.production
├─ .eslintignore
├─ .eslintrc.js
├─ .gitignore
├─ .prettierignore
├─ .prettierrc.js
├─ .commitlint.config.js
├─ .stylelint.config
├─ index.html
├─ package.json
├─ README.md
├─ tailwind.config.js
├─ tsconfig.json
└─ vite.config.ts

安装使用

  • 安装依赖
npm install
  • 运行
# 其他端请查看 package.json script
npm dev:h5
  • 打包
# 其他端请查看 package.json script
npm build:h5
  • npm run cz提交命令 先git add. 后在使用这个命令
npm run cz

提交类型

提交类型 标题 描述
feat 特征 新功能、新特性
fix Bug 修复 bug 修复
docs 文档 仅文档更改
style 风格 不影响代码含义的更改(空格、格式、缺少分号等)
refactor 代码重构 重构,在不影响代码内部行为,功能下的代码修改
perf 性能改进 更改代码,以提高性能
test 测试 添加缺失的测试或纠正现有的测试
build 构建 影响构建系统或外部依赖项的更改(示例范围:gulp、broccoli、npm)
ci 持续集成 对我们的 CI 配置文件和脚本的更改(示例范围:Travis、Circle、BrowserStack、SauceLabs)
chore 其他文件修改 不修改 src 或测试文件的其他更改
revert 还原 恢复之前的提交
release 发布新版本 -
workflow 工作流相关文件修改 -

Image text

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT License

Copyright (c) 2023 周艳凯

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问