Rapidpro Community Portal

Below you will find basic setup and deployment instructions for the rapidpro_community_portal project. To begin you should have the following applications installed on your local development system:

- Python >= 3.8
- `pip <http://www.pip-installer.org/>`_ >= 19
- `virtualenv <http://www.virtualenv.org/>`_ >= 1.10
- `virtualenvwrapper <http://pypi.python.org/pypi/virtualenvwrapper>`_ >= 16.0
- Postgres >= 12
- git >= 12.7

Getting Started

First clone the repository from Github and switch to the new directory:

git clone git@github.com:rapidpro/rapidpro-community-portal.git
cd rapidpro-community-portal

To setup your local environment you should create a virtualenv and install the necessary requirements:

pipenv shell
pipenv sync --dev

Create an .env file in the project home copying .env-template file and fill it properly:

cp .env-template .env

Create the Postgres database and run the initial migrate, which will also execute any required migrations:

createdb -E UTF-8 rapidpro_community_portal
python manage.py migrate

You should now be able to run the development server:

python manage.py runserver

Running the tests

You can run the tests via:

python manage.py test src/

Create images

create docker image and push on github:

update version in Makefile
make release

Run docker-compose

run docker-compose using images:

docker-compose pull
docker-compose up

UserVoice Templates

Sign on to http://rapidpro.uservoice.com/ Click Admin Console (next to the user avatar) Click Web Portal (from the gear) Click Appearance and features Click HTML/CSS/Javascript

Only the CSS and the Header are modified. Backup changes in mockups/uservoice