webstore

Web client for BananaHackers Store

Features

• List apps from BananaHackers' main GitLab store-db instance, or the community mirror on GitHub & filter apps.
• View apps information.
• Download apps manually, or by using clients supporting QR codes with bhackers:<app-name> scheme .

Building

The WebStore can be run directly from src/index.html in this Git repository. For GitHub pages hosting, you will need to build it (run these commands relative to the project directory):

• Install build dependencies:

  npm install -g gulp-cli
  npm install

• Build the project:

  gulp

and of course enable GitHub Pages and set it to host from docs/. You will need to run the 'Build the project' step every commit to have the changes from src/ be reflected on GitHub Pages.

Contributing

Please refer to CONTRIBUTING.md in this Git repository, but tldr here for anyone too lazy to read:

• Respect others and maintain the code of conduct. Please read CODE_OF_CONDUCT.md in this Git repository.

License

This project is licensed under the GPLv3 license. A copy is included in LICENSE.txt in this Git repository.

Credits & thanks

This project wouldn't have been possible without the following resources and projects:

Third-party libraries & services

• Bulma: https://bulma.io/
• QRCodeJS by: https://github.com/davidshimjs/qrcodejs
• GitHub fork ribbon CSS: https://github.com/simonwhitaker/github-fork-ribbon-css
• Bulma Floating Buttons: https://github.com/alakise/bulma-floating-button,
• Bulma Toast: https://github.com/rfoel/bulma-toast
• Font Awesome 5: https://fontawesome.com/
• Animate.CSS: https://github.com/animate-css/animate.css
• darkmode.js: https://github.com/nickdeny/darkmode.js
• i18next: https://www.i18next.com/
• loc-i18next: https://github.com/mthh/loc-i18next
• i18next-browser-languagedetecter: https://github.com/i18next/i18next-browser-languageDetector
• i18next-fetch-backend: https://github.com/dotcore64/i18next-fetch-backend
• relativetime.js: adapted from https://stackoverflow.com/a/53800501/13319205
• cors.bridged.cc: https://blog.grida.co/cors-anywhere-for-everyone-free-reliable-cors-proxy-service-73507192714e

Translations

• Tagalog: Cyan (https://github.com/cyan-2048)
• Polski: doru_ (https://github.com/sl4Zone)
• Tiếng Việt: minhduc_bui1

and all the people at BananaHackers, 4Omin, perry, Farooq Karimi Zadeh and LiarOnce for maintaining the BananaHackers Store on GitLab and GitHub, and of course, all the Mozilla Developer Network documentation ;)