foRAg'r is a mobile app that helps user keep track of food items in their fridge. Features include parsing receipt, searching food by keywords and sending notifications when food is near expiry.
The app is best viewed on iPhone or Android devices.
Note: This is the frontend repo. The backend repo can be viewed here.
Informative login page with a preview of features available
An overview of food items present in user's fridge
User can choose to take photo of receipt/upload photo of receipt to automatically add food items to fridge
Users can search food items by keywords
Users can search food items by keywords
When food is near expiry, native notifications will appear even when phone screen is locked
Tech | Purpose | |
---|---|---|
Frontend | React Native | User interface |
Expo | React Native framework | |
NativeBase | Component library | |
Lottie | Animated loaders | |
Backend | Node.js | Server |
Express | Server | |
PostgreSQL | Database | |
Sequelize | Database | |
Functionality | JWT | Authentication |
The backend is already hosted on Heroku and no setup is necessary. However, there are frontend environment variables that are not tracked in this repo. Please contact the developers if you would like to run this project locally on your machine. We will also require an email address that's tied to your Google Account in order to set up the OAuth Login for you.
Requirements
- npm:
npm install npm@latest -g
- Expo Go: Install Expo Go on your mobile device from the App Store ('Expo') or Play Store ('Expo Go').
To run the app
- Clone this repo
- Install dependencies:
npm i
- The devs will share a secret file with you; save this to the main folder
- Run the app:
expo start
- Scan the generated QR code with your phone to view the app on your mobile device
Cheena Eng | GitHub • LinkedIn • Email
Elizabeth Tan | GitHub • LinkedIn • Email