Repository files navigation

Flask + Vue.js Web Application Template

• Minimal Flask 1.0 App
• Flask-RestPlus API with class-based secure resource routing
• StarterPyTest test suite
• vue-cli 3 + yarn
• Vuex
• Vue Router
• Axios for backend communication
• Sample VueFilters
• Heroku Configuration with one-click deployment + Gunicorn

Live Demo

If this setup is not what you are looking for, here are some similar projects:

• oleg-agapov/flask-vue-spa
• testdrivenio/flask-vue-crud

This template was updated to use a flatter folder structure and use yarn instead of npm.You can now runyarn serve as well as other yarn commands from the template root directory.The old template will be kept in thenpm-template branch but will not be maintained.

Prefer Django? Checkout thegtalarico/django-vue-template

The template uses Flask & Flask-RestPlus to create a minimal REST style API,and let's VueJs + vue-cli handle the front end and asset pipline.Data from the python server to the Vue application is passed by making Ajax requests.

The Api is served using a Flask blueprint at/api/ using Flask RestPlus class-basedresource routing.

A Flask view is used to serve theindex.html as an entry point into the Vue app at the endpoint/.

The template uses vue-cli 3 and assumes Vue Cli & Webpack will manage front-end resources and assets, so it does overwrite template delimiter.

The Vue instance is preconfigured with Filters, Vue-Router, Vuex; each of these can easilly removed if they are not desired.

Before getting started, you should have the following installed and running:

• Yarn -instructions
• Vue Cli 3 -instructions
• Python 3
• Pipenv (optional)
• Heroku Cli (if deploying to Heroku)

• Clone this repository:

   $ git clone https://github.com/gtalarico/flask-vuejs-template.git

• Setup virtual environment, install dependencies, and activate it:

   $ pipenv install --dev $ pipenv shell

• Install JS dependencies

   $ yarn install

Run Flask Api development server:

$ python run.py

From another tab in the same directory, start the webpack dev server:

$ yarn serve

The Vuejs application will be served fromlocalhost:8080 and the Flask Apiand static files will be served fromlocalhost:5000.

The dual dev-server setup allows you to take advantage ofwebpack's development server with hot module replacement.

Proxy config invue.config.js is used to route the requestsback to Flask's Api on port 5000.

If you would rather run a single dev server, you can run Flask'sdevelopment server only on:5000, but you have to build build the Vue app firstand the page will not reload on changes.

$ yarn build$ python run.py

This template is configured to work with Heroku + Gunicorn and it's pre-configuredto have Heroku build the application before releasing it.

Heroku's nodejs buidlpack will handle install for all the dependencies from thepackages.json file.It will then trigger thepostinstall command which callsyarn build.This will create the bundleddist folder which will be served by whitenoise.

The python buildpack will detect thePipfile and install all the python dependencies.

Here are the commands we need to run to get things setup on the Heroku side:

```$ heroku apps:create flask-vuejs-template-demo$ heroku git:remote --app flask-vuejs-template-demo$ heroku buildpacks:add --index 1 heroku/nodejs$ heroku buildpacks:add --index 2 heroku/python$ heroku config:set FLASK_ENV=production$ heroku config:set FLASK_SECRET=SuperSecretKey$ git push heroku```