QR Code Tutorial
This tutorial explains the QR Code demo available on GitHub and shows you how to deploy it to the Nimbella Cloud.
The QR Code demo is a stateless single-page web application that generates a QR code from text that a user submits. You can view the app here. The QR Code demo has the following code and configuration components:
- A single index.html file, which has a field for a visitor to enter some text and click Submit.
- A Node package manager file called package.json, which describes what dependencies the function has.
Project file structure
The GitHub project has the file structure that Nimbella uses to intelligently deploy the project:
The packages directory contains the project's actions, and in this example, there's only one. The first subdirectory name usually serves as the package qualifier, but when it's named default, no qualifier is prepended to the action name. The next subdirectory, qr, is the name of the action, and the qr.js file contains the logic for that action.
The web directory contains the web content for the project. In this case, there is just one HTML file and one image. The index.html file contains a form with a text box for the user to input the text that will be converted.
Notes on QR logic
The code for the QR action is standard Node.js. It uses an existing Node library for the actual code generation.
Notes on QR web content
The index.html file contains the usual markup and logic that you'd write for standard web deployment, with an input form for text. In this case, it calls an API to retrieve a QR code for the form input. This API is implemented by qr.js.
Notes on package.json
The package.json file in the qr directory triggers an automatic build of the action when the qr.js file is modified. For more information about builds, see the section on incorporating build steps in the Nimbella Command Line Tool document.
Deploy this project to the Nimbella Cloud
If you have the Nimbella command line tool called
nim installed, you can deploy this project directly from GitHub, either online or from the local repository cloned to your disk.
- Run the following command in your terminal:
nim project deploy /path/to/qrcodeThe output of this command will include a link to where the application is running in the cloud.