openfoodfacts/smooth-app

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

Weekly meetings

• We e-meet Thursdays at 17:30 Paris Time (16:30 London Time, 22:00 IST, 08:30 AM PT)
• Video call link: https://meet.google.com/gnp-frks-esc
• Join by phone: https://tel.meet/gnp-frks-esc?pin=1110549945262
• Add the Event to your Calendar by adding the Open Food Facts community calendar to your calendar
• Weekly Agenda: please add the Agenda items as early as you can. Make sure to check the Agenda items in advance of the meeting, so that we have the most informed discussions possible, leading to argumented decisions.
• The meeting will handle Agenda items first, and if time permits, collaborative bug triage.
• We strive to timebox the core of the meeting (decision making) to 30 minutes, with an optional free discussion/live debugging afterwards.
• We take comprehensive notes in the Weekly Agenda of agenda item discussions and of decisions taken.

🆕 The future of the app

Starting this April, we invite all users and contributors to build a vision for the app. All information are detailed on this blog post.

User interface

• Mockups on the current app and future plans to discuss

Feature Sprint

• We use feature-based sprints, tracked here

Code documentation

Code documentation on GitHub pages.

Current Release

• Latest commit deployed to Apple App Store: Released on Nov 29th as Build 835
• Latest commit deployed to PlayStore: 792 from Nov 6th 11AM

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.
• Install it on Android (Google Play, F-Droid or Amazon App Store) or iPhone/iPad. Note that a internal development build (Android or iPhone/iPad (App Store) if you'd like to use the results of your PRs quicker.

• 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
• 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

About this Repository

How to run the project

• Make sure you have installed flutter and all the requirements
  • Official flutter installation guide
• Currently, the app uses the previous version of Flutter (3.10). We plan to migrate soon.

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

Contributors