Building your first web app

Setting up

You need to create a folder in the 'Local Files' app and create an empty text file in it, named wapp.cfg.

Writing the configuration

Open wapp.cfg in the text editor. Type the following:

wapp="first-app"
name="My First App"
generic_name="A general app"
comment="My first web app."
website="https://example.com"
categories="Education;"
keywords="first;sample;example;"

Detailed explanation: The value of the first field, wapp, is the internal name of the app. It is also the name of the folder into which the web app is extracted. It is shown to the user when uninstalling the app. We do not recommend adding uppercase letters or numbers in the value of the wapp field. The second field, name, is the name shown in the application launcher. The third field, generic_name, is a short name which generally should apply to all web apps of its kind and not specific to this particular application. It is meant for compatibility with other GUIs. The fourth field, comment, should contain some basic information about the app. The fifth field, website, should contain the website which will be used to generate the web app. The sixth field, categories, should contain a semicolon-separated list of categories. Allowed categories can be found at https://specifications.freedesktop.org/menu-spec/latest/apa.html. The seventh field, keywords, should contain a semicolon-separated list of related keywords.

Building the web app

Open the terminal, change the current directory to the folder containing wapp.cfg and run wapp-creator.

You have successfully created your first web app!