- (Alternatively to this small tutorial, consider checking out https://appgenerator.yunohost.org !)
- Copy this app before working on it, using the 'Use this template' button on the Github repo
- Edit the
manifest.tomlwith app specific info - Edit the
install,upgrade,remove,backupandrestorescripts, and any relevant conf files inconf/- Using the script helpers documentation
- Edit the
change_urlandconfigscripts too, or remove them if you have no use of them - Add a
LICENSEfile for the package.- NB: this
LICENSEfile is not meant to necessarily be the same LICENSE as the upstream app - it is only the LICENSE you want this package's code to published with and you can choose it freely! (If you don't know which to choose, we recommend the AGPL-3)
- NB: this
- Edit files under the
doc/directory (see the page about documenting packages) - The
README.mdfiles are to be automatically generated by https://github.com/YunoHost/apps_tools/blob/main/readme_generator
Explain in a few (10~15) words the purpose of the app or what it actually does (it is meant to give a rough idea to users browsing a catalog of 100+ apps)
🛠️ Upstream Example app repository: https://some.forge.com/example/example
Pull request are welcome and should target the testing branch.
The testing branch can be tested using:
# fresh install:
sudo yunohost app install https://github.com/YunoHost-Apps/example_ynh/tree/testing
# upgrade an existing install:
sudo yunohost app upgrade example -u https://github.com/YunoHost-Apps/example_ynh/tree/testing
Please see https://doc.yunohost.org/packaging_apps for more information.

