Skip to content

Latest commit

 

History

History
65 lines (43 loc) · 1.9 KB

README.md

File metadata and controls

65 lines (43 loc) · 1.9 KB

Flask PWA

A progressive webapp template.

Flask PWA is supposed to be a goto template when I start a new Flask project. It is constructed on a Model-Template-Controller perspective, which I find clear enough for my current projects.

You can check a live version at Heroku.

Requirements

Features

  • Blueprint oriented, Flask 1.0 project
  • Instantly deployable on Heroku
  • Off-the-shelf progressive web app behaviour
  • Service worker based on Workbox

Installation

> git clone https://github.com/umluizlima/flask-pwa
> cd flask-pwa
> make environment
> make install

Usage

Due to the current Service Worker specification, the web browser will only allow its registration if the application is served over https, or on localhost for development purposes.

This makes nGrok useful for testing the PWA functionality, as it allows you to expose localhost over the internet with https included.

localhost

> make run

nGrok

> make flask run
> ngrok http 80

Deployment

Heroku

The app.json, Procfile, and runtime.txt files on this repository are specific for deployment on Heroku. It can be done by clicking the following button:

Deploy

Links

Licensing

This project is licensed under MIT license.