A brewing app for iOS and Android, built with Ionic Framework.

Go to our Releases page to download our Alpha release. This supports Android 4.1 and up.

1. Ionic installed globally
   • npm install -g cordova ionic
2. Gulp installed globally
   • npm install -g gulp

3. Karma installed globally
   • npm install -g karma-cli

1. Clone this repository
   • git clone [email protected]:OpenBrews/OpenBrews.git
2. cd into the repository folder.
3. Clone the repo's submodules
   • git submodule update --init --recursive
4. Install the remaining dependencies with npm install.
5. Finally, you can run the app via gulp && ionic serve [--lab].

1. First, follow the steps above to run the app locally.
2. Download the Ionic View App on your mobile device.
3. Create an Ionic View account.
4. cd into the repository folder
5. Run ionic upload. You will be prompted for your ionic view credentials.
   • If you receive an error such as www.zip cannot be found, press Ctrl c to stop the process. Run mv openbrews.zip www.zip, and run ionic upload again.

1. First, follow the steps to run the app locally, making sure your modules are up-to-date.
2. Install the Testing prereqs above.
3. cd into the openbrews/ directory.
4. Run karma start

1. Follow the steps to run locally above.
2. Download the Android SDK
3. cd into the OpenBrews/ folder.
4. Run ionic build android

• This will build an APK for debugging. To release an official version you need to use the --release flag, and I (Mike) need to sign it with my private key.

TODO

If you would like to use features which utilize the brewerydb API, please create an account and get your own API key here. This should be added to your openbrews/config.json file. If you do not have a config.json file, copy and rename openbrews/example.config.json.

Note: To make requests to the BreweryDB API in the browser you will need to allow CORS in the browser you are using.

Please, don't be afraid to ask for an invite to our slack chat. We can discuss problems and work through issues together. Email Mike for an invite.

This app is built using Ionic Framework, which is built on AngularJS. If you have no idea what Ionic is, and only know AngularJS, you'll probably be fine. We are also leveraging Ionic CSS (rather than Bootstrap). Other than that, the project uses GULP, Bower, and SCSS.

Monitor the Issues board for tasks that need to be completed. Check the comments on an issue to get all the background info and see if anyone else has started work on it. When you're ready to develop, fork the repository, do your work, and submit a PR. Please note that changes may be requested. If you become a regular contributor, I may add you as a collaborator to this repository.

We now have an Alpha release out, and we're working hard to deliver updates as fast as we can. Once the app is more stable and polished, we will release a Beta version on Android.

Release 1 will focus on delivering a core Recipe Builder app. It will be a standalone application, except for some data-gathering API calls to BreweryDB.

Down the line, I would like to have an Web App and an API that allows persistance of recipes across devices, public sharing of recipes, and more!

Email Mike with any questions or concerns you may have regarding this project.

Remember, if you like what we're doing here, please star this repository :)