The Zaparoo App is the primary user interface for using the Zaparoo Core service. It's a React web app built on Capacitor, which is deployed as a phone app on iOS and Android.
The Zaparoo App is released under the GPLv3 license including its paid features. You're free to do with it what you like under the conditions of the license and trademarks, but we ask in good faith to avoid redistributing the built app with these paid features enabled, as they're used to support development of the project.
- Node.js (NPM)
- Android Studio (if building for Android)
- Xcode (if building for iOS)
Plus all dependencies pulled in via NPM.
This project also depends on the Capacitor plugin Capawesome NFC which is currently released under a donationware license. Please submit an issue for a development copy of this plugin or remove it from the code after checking out.
After checking out:
- Run
npm installto install dependencies. - Run
npm run build && npx cap syncto build and sync web app with mobile app code. - Run
npx open iosornpx open androidto launch the appropriate mobile app IDE.
See the Capacitor iOS and Android documentation for information about setting up your app IDE environment correctly if you have issues.
The UI and UX of this app are tightly managed. If you make any major additions or changes to the UI of the app, expect them to go through a lot of scrutiny. We want people to contribute, but it's also important that the app is always kept user-friendly and accessible.
When you make additions or changes to any text in the app, be mindful those changes need to also be translated into every other language supported by the app.
When you contribute to the app, you accept that the app contains some paid features (Pro features) which may include your own contributions if they overlap in functionality. If this is the case, you agree that payments to enable the Pro version will still go to the Zaparoo Project even if they include your own work. You will be notified during the Pull Request process if this may be the case.
If you're not comfortable with this arrangement or would like to avoid overlap, Pro features are strictly defined as:
- Any feature that enables the app to act as a reader. That is, any feature which triggers the
launchZaparoo API command namespace, excluding those which are used to preview the result of a command. - Cosmetic features such as app icons and themes.
All other features of the Zaparoo App are free.
All contributors to the app will be included here and in the About page of the app itself. Contributors may also request a license key for the Pro version.
- Phoenix - Dutch/Nederlands
- Pink Melon - Korean/한국어
- RetroCastle - Chinese (Simplified)/中文
- Seexelas - French/Français
This repository contains Zaparoo trademark assets which are explicitly licensed to this project in this location by the trademark owner. These trademarks must be removed from the project or replaced if you intend to redistribute the project in any form. See the Zaparoo Terms of Use for further details.
