$ git clone https://github.com/hack4impact/flask-base.git
$ cd flask-base

$ pip install virtualenv
$ virtualenv -p /path/to/python3.x/installation env
$ source env/bin/activate

For mac users it will most likely be

$ pip install virtualenv
$ virtualenv -p python3 env
$ source env/bin/activate

Note: if you are using a python2.x version, point the -p value towards your python2.x path

$ xcode-select --install

Create a file called .env that contains environment variables in the following syntax: ENVIRONMENT_VARIABLE=value. For example, the mailing environment variables can be set as the following

MAIL_USERNAME=example@domain.com
MAIL_PASSWORD=SuperSecretPassword
SECRET_KEY=SuperRandomStringToBeUsedForEncryption

Note: do not include the .env file in any commits. This should remain private.

$ pip install -r requirements/common.txt
$ pip install -r requirements/dev.txt

Mac (using homebrew):

$ brew install redis

Linux:

$ sudo apt-get install redis-server

$ python manage.py recreate_db

$ python manage.py setup_dev

Note that this will create an admin user with email and password specified by the ADMIN_EMAIL and ADMIN_PASSWORD config variables. If not specified, they are both flask-base-admin@example.com and password respectively.

$ python manage.py add_fake_data

• Install the Live Reload browser plugin from here
• Run npm install
• Run gulp

$ source env/bin/activate
$ honcho start -f Local