{"id":17986396,"url":"https://github.com/espinr/quick-app-quick-start","last_synced_at":"2026-04-18T01:37:23.682Z","repository":{"id":119079020,"uuid":"381039356","full_name":"espinr/quick-app-quick-start","owner":"espinr","description":"Quick start guide on Quick Apps with a hello world example ","archived":false,"fork":false,"pushed_at":"2021-06-29T07:48:45.000Z","size":12095,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-06T20:47:26.300Z","etag":null,"topics":["android","quickapps","quickappseu"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/espinr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2021-06-28T13:21:42.000Z","updated_at":"2021-07-20T13:43:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"f2e76795-077c-4a6b-a147-a8cb175eed7c","html_url":"https://github.com/espinr/quick-app-quick-start","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/espinr/quick-app-quick-start","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espinr%2Fquick-app-quick-start","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espinr%2Fquick-app-quick-start/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espinr%2Fquick-app-quick-start/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espinr%2Fquick-app-quick-start/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/espinr","download_url":"https://codeload.github.com/espinr/quick-app-quick-start/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espinr%2Fquick-app-quick-start/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31953515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"ssl_error","status_checked_at":"2026-04-18T00:39:20.671Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["android","quickapps","quickappseu"],"created_at":"2024-10-29T18:29:32.392Z","updated_at":"2026-04-18T01:37:23.666Z","avatar_url":"https://github.com/espinr.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quick App Quick Start\n\nThis is a Getting Started Guide for Quick App with a basic 'hello world' sample code.\n\n[![node version][node-image]][node-url]\n[![hap-toolkit version][hap-toolkit-image]][hap-toolkit-url]\n\n[node-image]: https://img.shields.io/badge/node.js-%3E=_8-green.svg?style=flat-square\n[node-url]: http://nodejs.org/download/\n[hap-toolkit-image]: https://img.shields.io/badge/hap--toolkit-%3E=_0.6-blue.svg\n[hap-toolkit-url]: https://www.npmjs.com/package/hap-toolkit\n\n## Introduction\n\n[Quick App](https://quick-app-initiative.ow2.io/page/whitepaper/#what-is-a-quick-app) is an implementation of the emerging [W3C MiniApp standard](https://w3c.github.io/miniapp/white-paper/) that provides a framework for mobile application development based on widely known front-end web technologies (JavaScript, CSS,…). It enables developers to create “light” applications more efficiently with significant access to a host devices’ native resources and services.\n\nThis repository contains a contains an example to help developers to get started with quick app development. Learn more about quick apps, the framework, use cases and the community behind, on the [Quick App White Paper](https://quick-app-initiative.ow2.io/page/whitepaper/).  \n\n## Quick Start\n\n### Pre-requisite: Node.js\n\nThe development tools are based on [Node.js](https://nodejs.org), a JavaScript runtime built on Chrome's V8 JavaScript engine. Also, the installation of the tools will need the _npm_ package manager. \n\nIf you don't have Node.js already on your computer, you may download and run a [pre-built installer for your platform](https://nodejs.org/en/download/). Any of the latest stable versions are suitable since the Quick Apps tools will require (Node.js version 6.0 or higher).\n\n### Install hap-toolkit, the Compilation Tool\n\n[hap-toolkit](https://www.npmjs.com/package/hap-toolkit) is the software that enables you to create new Quick App projects, build and pack quick apps, and debug them. To install [hap-toolkit](https://www.npmjs.com/package/hap-toolkit):\n\n```bash\n$ npm install -g hap-toolkit\n```\n\nAfter installing hap-toolkit, run `hap -v` (view the current version) on the console to check it works.\n\n```bash\n$ hap -v\n```\nThe console must show the current version of the toolkit. Something like:\n\n```bash\n$ hap -v\n1.9.5\n```\n\n### Install the Quick App Debugger\n\nThe Quick App Debugger is an Android application you can use as quick app debugger. It enables the following functions:\n\n- Installation based on QR code scanning: configure the testing HTTP server address, download the quick app (rpk package), and launch the platform to run the rpk package;\n- Local installation: select the rpk package in the device file system, and launch the platform to run the rpk package;\n- Online update: resend the HTTP request to the testing server to update the rpk package, and launch the platform to run the rpk package;\n- Start debugging: launch the quick app platform to run the rpk package, starting the remote debugging tool;\n\nThe quick app debugger can be connected to the quick app runtime in the device (the system needs to have the latest official version of the quick app platform), or you also can download and install the [Quick App Platform Previewer](#alternative-quick-app-previewer) to provide an execution environment if your device doesn't have the quick app runtime platform.\n\nSo, you can download the debugger APK at https://statres.quickapp.cn/quickapp/quickapptool/release/platform/quickapp_debugger_v1090.apk\n\nYou can install it on an Android device. If the installation succeeds, you will see a screen like the following figure:\n\n![Quick App Debugger screenshot](./images/debugger_main.jpg)\n\n\n### (Alternative) Quick App Previewer\n\nIf your device does not have a built-in quick app running platform, or you want to try new functions and new features of different versions of the Quick App Platform.\n\nThe Quick App Previewer is an Android application that contains the basic functions of quick apps, acting like a super-app. \n\nOnce you download and install the Previewer, you can choose to run the rpk package in the Quick App Previewer through the Quick App Debugger to test the APIs and functions of the corresponding platform.\n\nNote: if you want to install an older version of the Quick App Previewer you have installed on your device, you need to uninstall the previous version of the Previewer.\n\nDownload the [Quick App Previewer v1091](https://statres.quickapp.cn/quickapp/quickapptool/release/platform/quickapp_platform_preview_release_v1091.apk). \n\nSince the Quick App Previewer acts as a super-app, you will be asked for specific permissions to manage and install Quick Apps, as shown in the following screenshot:\n\n![Quick App Previewer screenshot asking for permissions](./images/preview_install_permission.jpg)\n\n![Quick App Previewer screenshot after installation](./images/preview_install_permission.jpg)\n\n\n### Run the Project\n\nNow it's time to configure and launch the Quick App. Follow these steps:  \n\n1. In the root directory of the project, install the dependencies:\n```bash\n$ cd hello-world\n$ npm install\n```\n\n2. Compile and pack the quick app code\n```bash\n$ npm run build\n```\nNow you can find the rpk package (the quick app) in the `dist` directory. You can perform a [local installation](#local-installation).\n\n\n3. Run the server and monitor the updates while coding. The changes will be compiled and synchronized automatically. \n```bash\n$ npm run start\n```\n\nThis command is equivalent to:\n\n```bash\n$ hap server --watch\n```\n\nThe console will show the IP address and port of the HTTP server if it is properly launched.\n\n![Quick App Server launched](./images/server.png)\n\nYou can connect to this server from your Android device to try the Quick App. You can test your first Quick App on your device using either the Quick App Debugger for Android or a Web browser.\n\n\n### Test the Quick App on Your Device\n\n#### Load the Quick App Through the Debugger\n\nYou can preview the _hello world_ quick app using the Quick App Previewer. The Quick App Debugger lets you launch the quick app by different means, from a local file (i.e., loading the rpk package generated under the `dist/` directory) or scanning a QR code.\n\n\nThe following figure shows how the quick app is loaded from a QR code and how to force the creation of a bookmark on the device´s desktop.\n\n\u003cimg alt=\"Quick App Debugger loading a quick app from a QR Code\" src=\"./images/debugger.gif\" height=\"500\"\u003e\n\n#### View the Quick App on Your Browser\n\nOpening the server URL with your favorite browser or just scanning the QR code from your device, you will be able to preview the quick app online. Please, note that this is a limited preview, so not all the features will be available. Also, if you use various devices, please note that they need to be connected to the same network.\n\n![Sample Quick App on a browser](/images/hello-world.jpg)\n\n\n#### Local Installation\n\nYou can install quick apps directly from the device file system.\n\nUse the Quick App Debugger to locate and open a new rpk file (`INSTALL WITH FILE`). \n\n\n### Test the Quick App on Your Device\n\nThe toolkit enables a complete debugging process through the Web Inspector. You only need to select the `START DEBUGGING` option in the Quick App Debugger. \n\nThe computer running the server will open the Web Inspector allowing the complete audit of the quick app.\n\n![Web Inspector auditing a quick app](/images/inspector.png)\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fespinr%2Fquick-app-quick-start","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fespinr%2Fquick-app-quick-start","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fespinr%2Fquick-app-quick-start/lists"}