React-Redux-Flask

Boilerplate application for a Flask JWT Backend and a React/Redux Front-End with Material UI.

• Python 2.7+ or 3.x
• Pipenv
• Pytest
• Heroku
• Flask
• React
• Redux
• React-Router 2.0
• React-Router-Redux
• Babel 6
• SCSS processing
• Webpack

Install pipenv

$ pip install pipenv

Create Environment Variables for Database in .env file

export DATABASE_URL="postgresql://username:password@localhost/mydatabase"

or

export DATABASE_URL="mysql+mysqlconnector://username:password@localhost/mydatabase"

or

export DATABASE_URL="sqlite:///your.db"

(More about connection strings in this flask config guide.)

Load pipenv with environment variables and install requirements

$ pipenv install
$ pipenv shell

Setup Alembic for managing DB Migrations

$ python manage.py create_db
$ python manage.py db upgrade
$ python manage.py db migrate

To update database after creating new migrations, use:

$ python manage.py db upgrade

Install Front-End Requirements

$ cd static
$ npm install

Run Back-End

$ python manage.py runserver

Test Back-End

$ python test.py --cov-report=term --cov-report=html --cov=application/ tests/

Run Front-End

$ cd static
$ npm start

Build Front-End

$ npm run build:production

New to Python?

If you are approaching this demo as primarily a frontend dev with limited or no python experience, you may need to install a few things that a seasoned python dev would already have installed.

Most Macs already have python 2.7 installed but you may not have pip install. You can check to see if you have them installed:

$ python --version
$ pip --version 

If pip is not installed, you can follow this simple article to get both homebrew and python

After you install python, you can optionally also install python 3

$ brew install python3

Now you can check again to see if both python and pip are installed. Once pip is installed, you can download the required flask modules:

$ sudo pip install flask flask_script flask_migrate flask_bcrypt 

Now, you can decide on which database you wish to use.

New to MySQL?

If you decide on MySQL, install the free community edition of MySQL and MySQL Workbench

1. start MySQL from the System Preferences
2. open MySQL Workbench and create a database called mydatabase but don't create the tables since python will do that for you
3. Install the MySQL connector for Python, add the DATABASE_URL configuration, and create the database and tables

$ sudo pip install mysql-connector-python-rf
$ export DATABASE_URL="mysql+mysqlconnector://username:password@localhost/mydatabase"
$ python manage.py create_db

Note: you do not need to run "python manage.py db upgrade" or "python manage.py db migrate" if its your first go at it

4. Run Back-End

$ python manage.py runserver

If all goes well, you should see * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit) followed by a few more lines in the terminal.

5. open a new tab to the same directory and run the front end

$ cd static
$ npm install
$ npm start

6. open your browser to http://localhost:3000/register and setup your first account
7. enjoy! By this point, you should be able to create an account and login without errors.