miniprogram-template是一个快速开发小程序的解决方案,它基于 vant-weapp 实现。它使用了小程序目前支持的最新配置和 api,内置了 eslist + prettier 代码规范,husky + lint-staged Git 提交代码规范验证,提供了丰富的功能组件,它可以帮助你快速搭建企业级小程序产品原型,希望本项目都能帮助你敏捷开发企业需求。
建议
本项目的定位是小程序开发模版,适合当基础模板来进行二次开发,公共组件指在各种类型的小程序中都会使用到,后续会持续迭代,欢迎提 issues。
官方示例 | Fabrique 精品店 | 番茄博客园 |
---|---|---|
扫描下方小程序二维码,体验小程序模版示例:
- tabBar放置在主包中, 其他页面放置到对应的分包中
- 多环境发布
- dev test pre prod
- 组件
- custom-broken-network
- custom-iconfont
- custom-image
- custom-loading
- custom-more
- custom-nav-bar
- custom-nomore
- custom-rich-text
- custom-video
- custom-virtuali-list
- 全局配置
- eslist + prettier 代码规范
- husky + lint-staged git提交代码规范验证
- 支持scss语法[ less 语法需更改配置 ]
- 初始化获取已包含 networkType、isConnected、systemInfo
- npm 脚本设置环境变量,读取多种环境信息,基于 miniprogram-ci 实现自动化上传代码
- 工具类在 utils 文件夹中
- 路由表包含所有页面涉及交互跳转统一读取路由表路径,需个人维护
- 配置文件在 config 文件夹中
- 数据请求在 api 文件夹中
- 小程序发布后提示更新
你需要在本地安装 node 和 git。本项目技术栈基于 ES2015+、vant-weapp和dayjs,提前了解和学习这些知识会对使用本项目有很大的帮助。
本项目已经为你生成了一个完整的开发框架,提供了涵盖小程序开发的各类封装和规范,下面是整个项目的目录结构。
├── README.md
├── api
│ ├── content-service.js
│ └── user-service.js
├── app.js
├── app.json
├── app.scss
├── assets
│ ├── images
│ └── styles
├── components
│ ├── custom-broken-network
│ ├── custom-iconfont
│ ├── custom-image
│ └── custom-nav-bar
├── config
│ ├── development.js
│ ├── env.js
│ ├── index.js
│ ├── local.js
│ ├── preview.js
│ ├── production.js
│ └── test.js
├── miniprogram-ci.js
├── miniprogram_npm
│ ├── @vant
│ └── dayjs
├── package.json
├── packageA
│ └── logs
├── pages
│ ├── home
├── private.wx2f3fed2106f72ceb.key
├── project.config.json
├── project.private.config.json
├── sitemap.json
├── switch-env.js
├── utils
│ ├── request.js
│ ├── router.js
│ ├── util.js
│ └── wxs.wxs
└── yarn.lock
# 克隆项目
git clone https://github.com/zhihuifanqiechaodan/miniprogram-template.git
# 进入项目目录
cd miniprogram-template
# 安装依赖
yarn install
# 小程序编辑器-工具-构建
# 编译刷新
TIP
强烈建议使用 yarn 安装依赖,避免使用 npm 或者 cnpm 安装,可能会有各种诡异的 bug。
完成上述安装 构建 编译后即可看到小程序内容,当你看到下面的页面说明你操作成功了。
接下来你可以修改代码进行业务开发了,本项目内建了常用公共组件、全局路由管理等等各种实用的功能来辅助开发,你可以通过查看已有的工具类和封装方法来使用。
建议
使用前建议将目前项目中已有的配置和文件夹工具类先行查看一番,方便后续使用,其次小程序路由和跳转都进行了封装,方便统一管理,后续需要自行维护。
关于公共组件的介绍和使用请查看对应组件文件夹下的 README.md, 也可以查看公共组件介绍页面的 demo.
基于miniprogram-template模版开发上线的小程序已有多个,可参考 Fabrique 精品店 / 番茄博客园等。
对于一些小程序开发中常遇到的问题和解决方案欢迎讨论。
欢迎您提供宝贵的意见和建议,也欢迎提 issues 增加和修改功能或组件,另外如果可以的话请给个 start,感谢~
个人微信
v1.0.5(20230320)
v1.0.4(20221118)
v1.0.3(20221116)
v1.0.2(20221028)
v1.0.1 (20221020)