This repository has been archived on 2023-11-19. You can view files and clone it, but cannot push or open issues or pull requests.
goober-ionic/README.md
Morgan McMillian 811b9ab0b3 Updated README
2021-05-01 07:11:50 -07:00

78 lines
2 KiB
Markdown

# Goober, a mobile app for pnut.io
Copyright 2017 - 2018 Morgan McMillian
Goober is a cross platform mobile client for pnut.io built using the Ionic framework (http://ionicframework.com/).
## Contributing
**This project is no longer under active development or support. If you decide to fork and continue development let me know. I might transfer this project or link to the new effort whichever is appropriate.**
## LICENSE
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
## Core build dependencies
* Install Node.js (https://nodejs.org)
* Install the latest Ionic and Cordova tools
```bash
npm install -g ionic cordova
```
## Platform build dependencies
#### Android
* Install Java Development Kit
* https://java.com
* Install either Android Studio or the command line tools
* https://developer.android.com/studio/index.html#downloads
* Install Gradle (needed if you only installed the command line tools)
* https://gradle.org/
## Other build dependencies
Install required node modules
```bash
cd Goober
npm install
```
Install at least one target platform
```bash
ionic cordova platform add android
```
## Build and run using ionic framework
Copy src/providers/pnut-oauth.ts.sample to src/providers/pnut-oauth.ts and include the client ID provided by pnut.io. See the [developer documentation](https://pnut.io/docs/api/implementation/overview) for more details.
#### Browser
```bash
ionic serve --lab
```
#### Android
```bash
ionic cordova platform add android
ionic cordova build android
ionic cordova run android
```