KO
|
EN
gitlite — search
Search
#python
#java
#python3
#arduino
#golang
#machine-learning
#rust
#html
#flask
#javascript
#seismology
#nodejs
bikebuds
★ 11
Open GitHub ↗
Bikebuds: A Social Cycling Club
Download README (.md)
Explore Similar Repositories
vue-unit-test-demo
:
vue-unit-test = vue-test-utils + jest
tars
:
The Threat Actor Rosetta Stone (TARS) is a public listing to keep track of who keeps calling which actor groups by which names.
springboot-mybatis
:
springboot整合常用配置
Deep_Sort-Tracker
:
Simple Online and Realtime Tracking with a Deep Association Metric
lempo
:
LEMPO (Ldap Exposure on POrtainer) is an exploit for CVE-2018-19466 (LDAP Credentials Disclosure on Portainer). Featured @ DevFest Siberia 2018
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
bikebuds
?
Download (.md)
# Bikebuds This is not an officially supported Google product. ## Overview A hodge-podge of features to help encourage bikebuds to get out and be active. ## Architecture ### Authentication Uses firebase for authentication and user management. ### Services Three major services all running on standard environment Python App Engine: frontend, backend, api. #### Frontend React + Material-UI Based on the create-react-app npm app, extended with several other react libraries. - https://github.com/facebook/create-react-app - https://material-ui.com/ - https://github.com/firebase/firebaseui-web-react - https://github.com/firebase/firebaseui-web/ - etc... #### Backend Standard Flask App Engine Service. #### API Python Cloud Endpoints Frameworks v2. ### Android Uses Official Material Components, firebase libraries and play services. Deprecated. ### Flutter (Replaces Android app) Uses Official Flutter components and firebase libraries. ## Development Most details below assume you're using a linux machine for development. ### Dependencies bikebuds development requires: - Python 2.7 - https://www.python.org/downloads/ (See "Specific Releases"). - PIP 2.x - https://pypi.org/project/pip/ - virtualenv - https://virtualenv.pypa.io/en/latest/ - gCloud CLI - https://cloud.google.com/sdk/gcloud/ - NPM - https://www.npmjs.com/get-npm - Android Studio - package:args/args.dart - Flutter SDK - https://flutter.io/docs/get-started/install ### Setup From the root directory: ``` # Ensure you have the right apps on your machine to do development. ./tools/setup/dev.sh # Installs pre-reqs # Ensure the source tree links to the proper configs, so you can compile. ./tools/setup/env.sh # Sets up ``` #### Git Hooks `dev.sh` sets the repo's core.hooksPath to tools/githooks. Hooks include: 1. husky -- Run all affected tests in the frontend project. 2. flutter test -- Run all tests for the flutter app. ### Evironment Configs The setup script directs you to clone some environment git repos. There are two, dev and prod. If you're jlapenna, you need prod to push; otherwise you only need dev. If you're on the dev geam, you can clone that with the provided command. If you're jlapenna or the dev team, you can create a directory that looks a lot like this: ``` dev ├── app_configs │ ├── GoogleService-Info-app.plist │ ├── GoogleService-Info-next.plist │ ├── google-services-app-android.json │ └── google-services-next-android.json ├── config.json ├── debug.keystore ├── dev -> dev └── service_keys ├── firebase-adminsdk.json ├── fitbit.json ├── strava.json └── withings.json ``` #### dev/config.json ``` { "project_id": "", "api_key": "", "auth_domain": "", "database_url": "", "storage_bucket": "", "message_sender_id": "", "vapid_key": "", "next_project_id": "", "next_api_key": "", "next_auth_domain": "", "next_database_url": "", "next_storage_bucket": "", "next_message_sender_id": "", "devserver_url": "http://localhost:8080", "frontend_url": "http://localhost:8081", "api_url": "http://localhost:8082", "backend_url": "http://localhost:8083" } ``` #### dev/service_keys/fitbit.json ``` { "admin_account": "user@domain", "client_id": "XXX", "client_secret": "YYY", "callback_url": "http://localhost:8082/fitbit/redirect", "authorization_uri": "https://www.fitbit.com/oauth2/authorize", "access_token_request_uri": "https://api.fitbit.com/oauth2/token" } ``` #### dev/service_keys/strava.json ``` { "client_id": "XXX", "client_secret": "YYY", "access_token": "ZZZ" } ``` #### dev/service_keys/withings.json ``` { "admin_account": "user@domain", "client_id": "XXX", "client_secret": "YYY", } ``` ### Running Local Backend & Frontend Services ``` ./gae/local.sh ``` You should be able to visit localhost:8080 to see the frontend. Note: localhost:8081 also serves the frontend, but it will serve the latest production npm build of the react app. You probably dont' want this. ### API Updates Whenever you add a new API method or modify its signature, be sure to generate new API specs: ``` ./gae/update_api.sh ``` ### Local flutter development Set up port-forwards on your android device so the flutter app can talk to the local backend. ``` ./flutter/local.sh ``` ## Production If you're not jlapenna@ you can stop reading. ;) ### Backend ``` ./gae/deploy.sh ``` ### Flutter ``` ./flutter/release.sh ``` ## Python Client A python client exists in gae/client. You can use it from the root directory, like so: ``` gae/client/ipython.sh ```
