WebApp boilerplate with React JS and Flask API

Build web applications using React.js for the front end and python/flask for your backend API.

Documentation can be found here: https://start.4geeksacademy.com/starters/react-flask
Here is a video on how to use this template
Integrated with Pipenv for package managing.
Fast deloyment to heroku in just a few steps here.
Use of .env file.
SQLAlchemy integration for database abstraction.

Manual Installation:

It is recomended to install the backend first, make sure you have Python 3.8, Pipenv and a database engine (Posgress recomended)

Install the python packages: $ pipenv install
Create a .env file based on the .env.example: $ cp .env.example .env
Install your database engine and create your database, depending on your database you have to create a DATABASE_URL variable with one of the possible values, make sure you replace the valudes with your database information:

Engine	DATABASE_URL
SQLite	sqlite:////test.db
MySQL	mysql://username:password@localhost:port/example
Postgress	postgres://username:password@localhost:5432/example

Migrate the migrations: $ pipenv run migrate (skip if you have not made changes to the models on the ./src/api/models.py)
Run the migrations: $ pipenv run upgrade
Run the application: $ pipenv run start

Backend Populate Table Users

To insert test users in the database execute the following command:

$ flask insert-test-users 5

And you will see the following message:

  Creating test users
  test_user1@test.com created.
  test_user2@test.com created.
  test_user3@test.com created.
  test_user4@test.com created.
  test_user5@test.com created.
  Users created successfully!

To update with all yours tables you can edit the file app.py and go to the line 80 to insert the code to populate others tables

Front-End Manual Installation:

Make sure you are using node version 14+ and that you have already successfully installed and runned the backend.

Install the packages: $ npm install
Start coding! start the webpack dev server $ npm run start

Publish your website!

This boilerplate it's 100% read to deploy with Render.com and Heroku in a matter of minutes. Please read the official documentation about it.

Contributors

This template was built as part of the 4Geeks Academy Coding Bootcamp by Alejandro Sanchez and many other contributors. Find out more about our Full Stack Developer Course, and Data Science Bootcamp.