miniFridge is a fridge management application that allows users to keep track of the items they have in their fridge. The app allows users to add/update/delete items to a virtual fridge list complete with expiration, location in fridge and quantity information. The app also includes a shopping list that users can add items to to keep track of when shopping. The items in the shopping list can quickly and easily be moved to the fridge list and vice versa. Data storage and authentication is all handled by Firebase.
npm install -g ionic cordova
In order to install miniFridge onto your computer, clone this repository and then navigate to the folder in your terminal.
git clone https://github.com/garykphuang/miniFridge
To install all the dependencies for miniFridge, run:
npm install
To run the app in your browser, enter the following into your terminal while in the miniFridge folder.
ionic serve
or
ionic serve -lab
"ionic serve" runs it directly in browser form while "ionic serve -lab" runs it in your browser on multiple platform such as Android or iOS.
When it finishes building, your browser should open automatically with the app. If it doesn't, miniFridge will be running on http://localhost:8100 by default.
First, you will need to add the desired platform to the project. You can do this by running
ionic cordova platform add <platform>
Where <platform> can be ios or android.
For android, connect your device by USB to your computer. Ensure developer settings (USB debugging, specifically) is on on your device. Run
ionic cordova run android --device
which will run your app and deploy it on your Android device in debug mode.
iOS is a bit more complex. Connect your device to your computer. Ensure developer settings (USB debugging) is on, and open the project in xcode. You'll need to sign your app using your Apple ID and enter a unique bundle identifier. From the drop down menu, select the connected device as the active scheme (near the run and terminate buttons in the top left corner). Press the run button. If an error occurs, go into settings on the device and enter Device Management to trust the developer (the Apple ID used to sign the app). This will run your app and deploy it on your Apple device in debug mode.
When handling updates, removing and re-adding the platform (using
ionic cordova platform remove/add ios
) will be necessary, as xcode does not update itself automatically.
Do not use ionic cordova platform update ios. It doesn't work.
- Ionic - Hybrid Framework
- Firebase - Database and Authentication
- Moment.js - Time and Date Handling
- rxjs - Asynchronous calls
- Zeka Dizdar
- Gary Huang
- Abigail Poole
See also the list of contributors who participated in this project.