A simple pros and cons app for android and web, with no adds, trackers nor malware. Free as in freedom.
This project was bootstrapped with Ionic and Create React App. We use Capacitor for the native app builds.
The project has been developed using NodeJS v14 so we encourage you to do the same. If you use nvm, you can simply run nvm use in the root of the project and it will automatically set that version for you.
The package manager we use is yarn.
In case you want to build an Android or iOS app you need to install the Ionic CLI and Android Studio as well.
Run the command yarn build and the web application will be available under the build directory.
Requires Ionic CLI and Android Studio.
Run the command ionic cap build android and the android project will be available under the android directory.
If you only want to run the app, you can run the command ionic cap run android and the app will be run in your pluged device or in a simulator.
Requires Ionic CLI, XCode and a Mac machine.
Run the command ionic cap build ios and the ios project will be available under the ios directory.
If you only want to run the app, you can run the command ionic cap run ios and the app will be run in your pluged device or in a simulator.
In the project directory, you can run:
Installs all the dependencies.
Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.
Launches the test runner in the interactive watch mode.
See the section about running tests for more information.
Shows the test coverage for the unit tests.
Builds the web app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
See the section about deployment for more information.
Runs eslint and prettier on all the files in the /src folder. This linter has been configured to be extended with rules for jest, prettier and cypress.
Opens up the cypress UI for running the e2e test suite.
Bundles and creates the android App so that it can be run on any android phone or simulator. This command requires having the Ionic CLI installed.
You can contribute in many ways in this project. From the design and UX to the implementation. Any help is more than welcome.
Another way is simply by downloading the app from FDroid or Play Store. You can always create a pros and cons list about creating a pros and cons list!