This is the official repository for the Berkeley Mobile iOS application.
Created in 2012, Berkeley Mobile has acculumated over 20,000 downloads on iOS and Android and currently has about 2,000 Monthly Active Users (MAUs). It has Bear Transit routes, library and gym information, dining hall menus, and campus resources, all in one place for the busy Berkeley student. The mission of Berkeley Mobile is to use cool technology to help students navigate Berkeley. You can download Berkeley Mobile on the Google Play Store or the App Store.
Berkeley Mobile is a product of the Associated Students of University of California (ASUC) Office of the Chief Technology Officer (OCTO) and is not affiliated with the University of California, Berkeley or the Regents of the University of California.
For documentation, check out our wiki. The wiki is a work in progress and should be completed soon.
The application consists of eight modules:
- Academics: for Libraries and Campus Resources features
- Dining: for dining hall and cafe features
- Favorites: favoriting feature
- Recreation: for gyms and gym classes features
- Resource: acts as the base for features
- Search: search functionality, currently not being used
- Transit: for Bear Transit feature
- Util: some misc. utilities
It is recommended you use XCode 9.2 or higher and Swift 3. Install Cocoapods and be sure to run pod install in the berkeley-mobile-ios directory.
- Create a new project in the Google Cloud Console
- Under the APIs and Services tab, enable the Google Places API for iOS, Google Maps SDK for iOS, Google Maps Directions API, and Google Maps Geocoding API
- Under the Credentials tab, create an API key
- Paste your API key into secret.swift and GoogleService-Info.plist
- We've configured this repository so that the application pulls from our sandbox backend, which just returns test data. If you would like access to our production backend API, please contact us.
See CONTRIBUTING.md for more information.
The following is a summary of open tasks and issues. For new contributors, we recommend focusing on Improvements. Before starting to work on new features or large changes not listed below, especially ones that involve UI changes or new APIs, please contact us!
- Crowd sourcing water fountain, microwave, and nap pod locations
- Favoriting items such as libraries, food items
- We might be open to partnerships with student orgs
You can contact the Berkeley Mobile team at octo.berkeleymobile@asuc.org with any questions.
This project uses the Educational Community License (ECL) 2.0. See LICENSE.md for more information.