Installation ############ This application is written in Python (API) and Javascript (client): - API: - Flask - `gpxpy `__ to parse gpx files - `staticmap `__ to generate a static map image from gpx coordinates - `python-forecast.io `__ to fetch weather data from `Dark Sky `__ (former forecast.io) - Client: - React/Redux - `Leaflet `__ to display map - `Recharts `__ to display charts with elevation and speed Sports and weather icons are made by `Freepik `__ from `www.flaticon.com `__. Prerequisites ~~~~~~~~~~~~~ - PostgreSQL database (10+) - Python 3.7+ - `Poetry `__ - `Yarn `__ and `serve `__ - API key from `ThunderForest `__ - API key from `Dark Sky `__ [not mandatory] Installation ~~~~~~~~~~~~ | The following steps describe an installation on Linux systems (tested on Debian and Arch). | On other OS, some issues can be encountered and adaptations may be necessary. .. warning:: Since FitTrackee 0.2.1, Python packages installation needs Poetry. To install it on ArchLinux: .. code-block:: bash $ yaourt poetry $ poetry --version Poetry 0.12.17 # optional $ poetry config settings.virtualenvs.in-project true For other OS, see `Poetry Documentation `__ Dev environment ^^^^^^^^^^^^^^^ - Clone this repo: .. code:: bash $ git clone https://github.com/SamR1/FitTrackee.git $ cd FitTrackee - Update **Makefile.config** file if needed and copy/paste the **ThunderForest** and **Dark Sky** API keys value in **Makefile.custom.config** file (see `Environment variables `__). - Install Python virtualenv, React and all related packages and initialize the database: .. code:: bash $ make install-dev $ make install-db - Start the server and the client: .. code:: bash $ make serve Open http://localhost:3000 and login (the email is ``admin@example.com`` and the password ``mpwoadmin``) or register Prod environment ^^^^^^^^^^^^^^^^ .. warning:: Note that FitTrackee is not production-ready yet - Download the last release (for now it is the beta release v0.2.0): .. code:: bash $ wget https://github.com/SamR1/FitTrackee/archive/v0.2.0-beta.tar.gz $ tar -xzf v0.2.0-beta.tar.gz $ mv FitTrackee-0.2.0-beta FitTrackee $ cd FitTrackee - Update **Makefile.config** file if needed and copy/paste the **ThunderForest** and **Dark Sky** API keys value in **Makefile.custom.config** file (see `Environment variables `__). - Install Python virtualenv, React and all related packages and initialize the database: .. code:: bash $ make install $ make install-db - Build the client: .. code:: bash $ make build-client - Start the server and the client: .. code:: bash $ make run Open http://localhost:3000, log in as admin (the email is ``admin@example.com`` and the password ``mpwoadmin``) and change the password Upgrade ~~~~~~~ .. warning:: | Before upgrading, make a backup of all data: | - database (with `pg_dump `__ for instance) | - upload directory: **FitTrackee/fittrackee_api/fittrackee_api/uploads/** Dev environment ^^^^^^^^^^^^^^^ - Stop the application and pull the repository: .. code:: bash $ git pull - Update **Makefile.config** and **Makefile.custom.config** file if needed - Upgrade packages and database: .. code:: bash $ make install-dev $ make upgrade-db - Restart the server and the client: .. code:: bash $ make serve Prod environment ^^^^^^^^^^^^^^^^ ``TODO`` Environment variables ~~~~~~~~~~~~~~~~~~~~~ The following environment variables must be defined in **Makefile.custom.config**: .. cssclass:: table-bordered table-striped ===================================== ======================================= ==================================== variable description app default value ===================================== ======================================= ==================================== ``REACT_APP_GPX_LIMIT_IMPORT`` max. number of gpx file in zip archive 10 ``REACT_APP_MAX_SINGLE_FILE_SIZE`` max. size of a gpx or picture file 1MB ``REACT_APP_MAX_ZIP_FILE_SIZE`` max. size of a zip archive 10MB ``REACT_APP_ALLOW_REGISTRATION`` allows users to register true ``REACT_APP_THUNDERFOREST_API_KEY`` ThunderForest API key no defaut value, must be initialized ``WEATHER_API`` DarkSky API key no defaut value, not mandatory ===================================== ======================================= ====================================