Taarifa Waterpoints
===================

Overview
--------

Taarifa Waterpoints is a mapping application for waterpoint management system for Tanzania. It has frontend written in JavaScript and backed in python. Uses TaarifaAPI as a framefork and MongoDB as a document storage.

Upstream URL: https://github.com/taarifa/TaarifaWaterpoints

API URL: https://github.com/taarifa/TaarifaAPI

Fork URL: https://github.com/trendspotter/TaarifaWaterpoints - the fork contains fixes for python3 compatibility and ready-to-use release package with frontent build using the method below.

Frontend build
--------------

Frontend requires ancient verions of packages to work correctly. Followin sequence produces usable dist directory on Debian 10.

.. code-block:: bash

    # Install build packages
    apt-get update
    apt-get -y install build-essential git libpng-dev xz-utils wget

    # Install Node.js 4
    wget https://nodejs.org/dist/latest-v4.x/node-v4.9.1-linux-x64.tar.xz
    mkdir -p /usr/local/lib/nodejs
    tar -xJvf node-v4.9.1-linux-x64.tar.xz -C /usr/local/lib/nodejs
    export PATH=/usr/local/lib/nodejs/node-v4.9.1-linux-x64/bin:${PATH}

    # Clone Taarifa Waterpoints
    git clone https://github.com/taarifa/TaarifaWaterpoints.git /tmp/taarifa
    cd /tmp/taarifa
    git checkout 7d0c784eb01b811e65c829796c88d9367f8fa5f7
    git cherry-pick -n 984a6353f8b50e9f7f643d22e5c77ad0eb352bcb

    # Install NPM packages
    export HOME=/root
    npm install
    npm install -g grunt-cli bower
    bower install --allow-root

    # Hackfix grunt task and build dist
    sed -i "s/'bower',//" Gruntfile.js
    grunt build