Skip to content

openfoodfacts/smooth-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5,197 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Smooth App: The new Openβ€―Foodβ€―Facts mobile app for Android and iPhone

GitHub language count GitHub top language GitHub last commit Github Repo Size

Presentation

  • This new mobile application aims to showcase Open Food Facts's power to a broad range of users through a smooth user experience and sleek user interface. It is a Flutter application by Open Food Facts.
  • We pioneered the collaborative scanning app in 2012. With this experimental app, we’re reinventing it from the ground up.

Stable version

Beta version

  • Google Play offers a Beta version you can join freely. We typically push to beta a couple of days before final release.

Testing version

  • Note that an internal development build (Android or iPhone/iPad (App Store) if you'd like to use the results of your PRs quicker.

app showcase

  • Smooth-app is developed in parallel to the openfoodfacts-dart plugin, which provides a high level interface with the Open Food Facts API and openfoodfacts_flutter_lints which provides specific linting
  • We also have smooth-app_assets to host assets used by the app (currently the tagline)
  • Every new interaction with the API should be implemented in the plugin in order to provide these new features to other developers.
  • We support desktop platforms (Linux, macOS and Windows), but only for development

Weekly meetings

Current Release

πŸ“š Code documentation

🎨 Design & User interface

Features of the app

✨ Features

Full list of features on the wiki: https://wiki.openfoodfacts.org/Mobile_App/Features

  • a scan that truly matches who you are (Green: the product matches your criteria, Red: there is a problem, Gray: Help us answer you by photographing the products)
  • a product page that's knowledgeable, building on the vast amount of food facts we collect collaboratively, and other sources of knowledge, to help you make better food decisions

You can

  • scan and compare in 15 seconds the 3 brands of tomato sauces left on the shelf, on your terms.
  • get a tailored comparison of any food category
  • set your preferences without ruining your privacy

Criteria you can pick

  • Environment: Eco-Score
  • Health: Additives & Ultra processed foods, Salt, Allergens, Nutri-Score

πŸš€ How to run the project

  • Make sure you have installed Flutter and all the requirements
  • Currently, the app uses the following version of Flutter: 3.38.5.
  • Setting Up Your Environment with FVM
    • To manage Flutter versions easily, download and install FVM (Flutter Version Management):
      • Install FVM by following the official FVM installation guide.
      • Once FVM is installed, run the following commands to set Flutter to version 3.38.5:
        fvm install 3.38.5
        fvm use 3.38.5
      • Verify the Flutter version with:
        fvm flutter --version

We have predefined run configurations for Android Studio and Visual Studio Code In order to run the application, make sure you are in the packages/smooth_app directory and run these commands:

  • flutter pub get .

  • On Android πŸ€–: flutter run -t lib/entrypoints/android/main_google_play.dart

  • On iOS/macOS 🍎: flutter run -t lib/entrypoints/ios/main_ios.dart

  • Troubleshooting : If you get an error like App depends on scanner shared from path which depends on camera_platform_interface from git, version solving failed. then run

    • flutter pub cache clean or manually delete the
    • C:\Users\~\AppData\Local\Pub\Cache file. Then redo the above procedure to run the app.
  • Contributing Guidelines


Thanks

The app was initially created by Primael. The new Open Food Facts app (smooth_app) was then made possible thanks to an initial grant by the Mozilla Foundation in February 2020, after Pierre pitched them the idea at FOSDEM. A HUGE THANKS 🧑 In addition to the core role of the community, we also had the support from several Google.org fellows and a ShareIt fellow that helped us eventually release the app in June 2022.

Contributors

List of contributors to this repository