{"id":18496570,"url":"https://github.com/nicejade/quickapp-boilerplate-template","last_synced_at":"2025-08-23T10:35:04.937Z","repository":{"id":41271458,"uuid":"156237291","full_name":"nicejade/quickapp-boilerplate-template","owner":"nicejade","description":"🔨致力于构建更为优雅的「快应用」开发脚手架模板。https://quickapp.lovejade.cn/tag/quickapp/","archived":false,"fork":false,"pushed_at":"2024-01-16T03:59:36.000Z","size":1243,"stargazers_count":77,"open_issues_count":14,"forks_count":21,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T17:11:40.894Z","etag":null,"topics":["boilerplate","kuaiyingyong","prettier","quickapp","template"],"latest_commit_sha":null,"homepage":"https://www.jeffjade.com/2018/11/11/145-quickapp-boilerplate-template/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicejade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-05T15:13:24.000Z","updated_at":"2024-11-14T11:50:38.000Z","dependencies_parsed_at":"2025-04-08T22:42:36.950Z","dependency_job_id":null,"html_url":"https://github.com/nicejade/quickapp-boilerplate-template","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nicejade/quickapp-boilerplate-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fquickapp-boilerplate-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fquickapp-boilerplate-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fquickapp-boilerplate-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fquickapp-boilerplate-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicejade","download_url":"https://codeload.github.com/nicejade/quickapp-boilerplate-template/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fquickapp-boilerplate-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271746658,"owners_count":24813575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boilerplate","kuaiyingyong","prettier","quickapp","template"],"created_at":"2024-11-06T13:29:58.479Z","updated_at":"2025-08-23T10:35:04.912Z","avatar_url":"https://github.com/nicejade.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://nicelinks.site?from=github\"\u003e\n    \u003cimg width=\"200\" height=\"200\" src=\"https://raw.githubusercontent.com/nicejade/quickapp-boilerplate-template/master/src/assets/images/logo.png\" alt=\"快应用脚手架模板\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003ch1 align=\"center\"\u003e快应用脚手架模板\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n  🔨 致力于构建更为优雅的\u003cstrong\u003e\u003ca href=\"https://nicelinks.site/post/5b5fb5bc615bf842b609105f\"\u003e快应用\u003c/a\u003e\u003c/strong\u003e开发脚手架模板\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://circleci.com/gh/nicejade/quickapp-boilerplate-template\"\u003e\n    \u003cimg src=\"https://circleci.com/gh/nicejade/quickapp-boilerplate-template/tree/master.svg?style=svg\" alt=\"Build Status\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://nodejs.org/en/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/node-%3E=%206.0.0-green.svg\" alt=\"node version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://nicelinks.site/post/5c16083e819ae45de1453caa\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat\" alt=\"Prettier\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/nicejade/quickapp-boilerplate-template\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/nicejade/quickapp-boilerplate-template.svg\" alt=\"LICENSE\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://nice.lovejade.cn/zh/article/quickapp-boilerplate-template.html\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/chat-on%20blog-brightgreen.svg\" alt=\"Chat On My Blog\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://aboutme.lovejade.cn/?from=github\"\u003e\u003cimg src=\"https://img.shields.io/badge/Author-nicejade-%23a696c8.svg\" alt=\"Author nicejade\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n## 目标与哲学\n\n[快应用](https://nicelinks.site/post/5b5fb5bc615bf842b609105f)是基于手机硬件平台的新型应用形态，标准是由主流手机厂商组成的`快应用联盟`联合制定。其标准的诞生将在研发接口、能力接入、开发者服务等层面建设标准平台，以平台化的生态模式对个人开发者和企业开发者全品类开放。[快应用](https://nicelinks.site/post/5b5fb5bc615bf842b609105f)具备传统 APP 完整的应用体验，`无需安装、即点即用`；`覆盖 10 亿设备`，`与操作系统深度集成，探索新型应用场景`。快应用 ── **复杂生活的简单答案，让生活更顺畅**。\n\n[快应用](https://nicelinks.site/post/5b5fb5bc615bf842b609105f)是一种新型的应用形态，由国内九大手机厂商基于硬件平台共同推出；秒开即点即用，更易于应用的传播和留存，可以为用户提供更高效的服务。在可预见的未来，其将有不错的应用场景和发展空间。此 [quickapp-boilerplate-template](https://github.com/nicejade/quickapp-boilerplate-template) 仓库的建立，旨在探索如何更为优雅的开发[快应用](https://nicelinks.site/post/5b5fb5bc615bf842b609105f)，为广大`快应用开发者`提供便利和参考，尽可能提升开发效率、优化开发体验，使得可以在更短时间内，塑造出更为优质的`快应用`。关于[快应用](https://nicelinks.site/post/5b5fb5bc615bf842b609105f)开发更详细资料，可参见[快应用教程资源列表](https://github.com/nicejade/nice-front-end-tutorial/blob/master/tutorial/quickapp-tutorial.md)。\n\n## 组织结构\n\n```\n├── sign                # 存储 rpk 包签名模块;\n└── src\n│   ├── assets          # 公用的资源(images/styles/字体...)\n│   │   ├──images       # 存储 png/jpg/svg 等公共图片资源\n│   │   ├──js           # 存储公共 javaScript 代码资源\n│   │   └──styles       # 存放 less/css/sass 等公共样式资源\n│   ├── helper          # 项目自定义辅助各类工具\n│   │   ├──apis         # 存储与后台请求接口相关(已封装好)\n│   │   ├──ajax.js      # 对系统提供的 fetch api 进行链式封装\n│   │   └──utils        # 存放项目所封装的工具类方法\n│   ├── pages           # 统一存放项目页面级代码\n│   ├── app.ux          # 应用程序代码的入口文件\n│   └── manifest.json   # 配置快应用基本信息\n└── package.json        # 定义项目需要的各种模块及配置信息\n```\n\n## 如何使用\n\n```bash\ngit clone https://github.com/nicejade/quickapp-boilerplate-template.git\ncd quickapp-boilerplate-template \u0026\u0026 yarn\nyarn start # 推荐 ✅✅\n\n# 或者运行以下命令\nyarn server \u0026 yarn watch\n\n# 或者在终端一 Tab 下运行：\nyarn server\n# 在终端另一 Tab 下运行：\nyarn watch\n\n# ✨ 新增「快应用」页面\nyarn gen YourPageName\n```\n\n用一台 `Android` 手机，下载安装[「快应用」调试器](https://www.quickapp.cn/docCenter/post/69)，打开后操作`扫码安装`，扫描如上命令生成的二维码，即可看到效果；更多讯息，请参见[快应用环境搭建](https://nice.lovejade.cn/zh/article/develop-quick-app-experience-notes.html#环境搭建)。\n\n## 改进优势\n\n有必要谈及的是，此项目秉承在[高效开发 Web 单页应用解决方案](https://nice.lovejade.cn/zh/article/vue-webpack-boilerplate-template.html)中所传递的理念：为**高效开发**而设计；相比于其内置的简陋 Demo，她具有以下诸多优点：\n\n- [x] **对项目结构进行优化**；如上组织结构所示，将各资源模块，更专业的分门别类，使之可以便捷的去编写、维护、查找，同时也是基于前端开发既定共识去设计，更容易为初接触者所理解 \u0026 上手；\n- [x] **更优雅的处理数据请求**；采用 `Promise` 对系统内置请求 `@system.fetch` 进行封装，并抛出至全局，使得可以极简的进行链式调用，同时便捷地处理返回数据，并能够使用  `finally`，设计详情可参见[如何优雅处理「快应用」数据请求\n](https://quickapp.lovejade.cn/how-to-elegantly-handle-quickapp-request/)；\n- [x] **内置了样式处理方案**；「快应用」支持 `less`, `sass` 的预编译；这里采取 `less` 方案，并内置了部分变量，以及常用混合方法，使得可以轻松开启样式编写、复用、修改等；\n- [x] **封装了常用方法**；在 `helper/utils` 路径下，有对日期、字符串、系统等常用方法，分别进行封装，统一暴露给 `global.$utils`，使得维护方式更加合理且健壮，同时又可以便捷的使用，高效开发；当然，你也可以根据需要自行增删、抑或扩展；\n- [x] **浏览器打开调试主页二维码**；运行 `yarn start`，会启动 HTTP 调试服务器，并将该地址在**命令行终端**显示，手机端用快应用调试器扫码，即可下载并运行 rpk 包；当终端积累的信息流多了，就造成扫码不便；故增设在浏览器打开调试主页二维码；如想不使用此功能，在 _command/server.js_ 文件中，将 **autoOpenBrowser** 设置为 `false` 即可；\n- [x] **集成轻粒子统计分析**； [轻粒子](https://nicelinks.site/post/5bdfa8ba9fa22b1b40974f63)作为官方推荐统计方案，此脚手架已做接入；使用时只需修改 [statistics.config.js](https://github.com/nicejade/quickapp-boilerplate-template/blob/master/src/assets/js/statistics.config.js) 中的 `app_key`，为在[轻粒子](http://www.qinglizi.cn/)所申请的快应用 KEY 即可；\n- [x] **添加新增页面命令脚本**；使得可以一键生成新页面，只需运行：`yarn gen YourPageName` （命名推荐统一为大驼峰，将会在 `pages` 路径下新建该页面文件夹）命令即可，当然，也可以根据需要，自行定定制模板：*/command/gen/template.ux*；\n- [x] **集成 [Prettier](https://prettier.io/) \u0026 [Eslint](https://eslint.org/)**；在检测代码中潜在问题的同时，统一团队代码规范、风格（`js`，`less`，`scss`等），从而促使写出高质量代码，以提升工作效率(尤其针对团队开发)。\n- [x] **编写 [prettier-plugin-quickapp](https://github.com/nicejade/prettier-plugin-quickapp) 插件**；为快应用编写 `prettier` 插件，使其可以针对 `.ux`/`.mix` 文件也能很好地工作，从而进一步完善代码风格及规范。\n- [x] **新增文件监听命令**：引入 [onchange](https://github.com/Qard/onchange) 依赖来监听文件变化；使得在开发时，运行 `yarn prettier-watch` 命令，即可对所修改的 `*.md` `*.ux` `*.js` 等文件，进行 **Prettier** 格式化，从而大幅度提升编写效率。\n- [ ] ... ...\n\n## 内置命令\n\n更推荐您直接使用[快应用 IDE](https://doc.quickapp.cn/ide/new.html)，具体可参见[快应用开发系列博文](https://forum.lovejade.cn/t/quickapp)；如果您基于 VsCode、SublimeText 等编辑器，开发快应用，以下命令可参考。\n\n|  命令 | 描述  | 备注 |\n|---|---|---|\n| `yarn start`  | 开启服务(server)和监听(watch)  | 附魔[多步优化](https://nice.lovejade.cn/zh/article/quickapp-boilerplate-template.html#%E6%94%B9%E8%BF%9B%E4%BC%98%E5%8A%BF)，一键开启开发，强烈推荐 ✔️|\n| `yarn server`  | 开启服务(server)  | 如不嫌麻烦，可使用，不推荐 |\n| `yarn watch`  | 开启监听(watch)  | 如不嫌麻烦，可使用，不推荐 |\n| `yarn build ` | 编译打包，生成 `rpk`包  | 对内置 `hap build` 命令的转接 |\n| `yarn release ` | 生成 `rpk`包并增加签名  | 对内置 `hap release` 命令的转接  |\n| `yarn gen `  | 新增「快应用」页面 | 助你高效生成页面，模版可自定义，推荐 ✓|\n| `yarn prettier`  | 一键美化代码(js/css/less/ux)  | 实在是团队开发好帮手，推荐 ✓ |\n| `yarn watcher`  | 对变化代码文件格式、实时美化 | 极大提升代码编写效率，强烈推荐 ✔️|\n\n## 相关链接\n\n- [**倾城之链**](https://nicelinks.site?from=github)\n- [About Me](https://aboutme.lovejade.cn/?from=github)\n- [个人博客](https://jeffjade.com/nicelinks)\n- [辅助博客](https://blog.lovejade.cn/)\n- [新浪微博](https://weibo.com/jeffjade)\n- [知乎主页](https://www.zhihu.com/people/yang-qiong-pu/)\n- [简书主页](https://www.jianshu.com/u/9aae3d8f4c3d)\n- [SegmentFault](https://segmentfault.com/u/jeffjade)\n- [Twitter](https://twitter.com/nicejadeyang)\n- [Facebook](https://www.facebook.com/nice.jade.yang)\n\n| 微信公众号 | 前端微信群 | 推荐 Web 应用 |\n| --- | --- | --- |\n| 😉 静晴轩 | ✨ 大前端联盟 | 🎉 倾城之链 |\n| ![静晴轩](https://image.nicelinks.site/qrcode_jqx.jpg) | ![倾城之链](https://image.nicelinks.site/wqycx-weixin.png?ver=1) |\u003cimg src=\"https://image.nicelinks.site/nice-links.png\" width=\"300px\" alt=\"倾城之链\"\u003e\u003c/img\u003e|\n\n## 许可执照\n\n[MIT](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2018-present, [nicejade](https://github.com/nicejade)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicejade%2Fquickapp-boilerplate-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicejade%2Fquickapp-boilerplate-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicejade%2Fquickapp-boilerplate-template/lists"}