Hello. Want to get started with Flask quickly? Good. You came to the right place. This Flask application framework is pre-configured with Flask-SQLAlchemy, Flask-WTF, Flask-Login, Flask-Admin, Fabric and the Bootstrap 5 frontend (among others). This will get your Flask app up and running on Heroku or PythonAnywhere quickly. Use this starter, boilerplate for all you new Flask projects. Cheers!
The Apache 2.0 license is still used for this project, therefore making me provide a changelog of sorts. I basically updated everything to be 2022-level and included a few convenient additions. Here's a list of the changes:
- Switched anything that can be cdn'd to CDNJS, including Bootstrap, Font Awesome, and jQuery.
- Updated to Bootstrap 5.1.3 and Fontawesome 6.1.1
- Removed Fabric
- Removed Modernizr and the useless Google Analytics
(if you can write a Flask app, you could probably configure Google Analytics) - Pre-configured Flask-SQLAlchemy, Flask-Login, Flask-WTF, and Flask-Admin for you.
- This implies that this has a full-fleged user management system already configured for you.
That's basically it. I suggest you read through the code and see if you can figure out what's going on. The Heroku and PythonAnywhere guides down below MIGHT NOT WORK (I DID NOT CHECK).
What is Flask? Flask is a microframework for Python based on Werkzeug and Jinja2.
├── Procfile
├── Procfile.dev
├── app.py
├── config.py
├── database.db
├── error.log
├── forms.py
├── models.py
├── requirements.txt
├── static
│ ├── css
│ │ └── main.css
│ ├── ico
│ │ ├── apple-touch-icon-114-precomposed.png
│ │ ├── apple-touch-icon-144-precomposed.png
│ │ ├── apple-touch-icon-57-precomposed.png
│ │ ├── apple-touch-icon-72-precomposed.png
│ │ └── favicon.png
│ ├── img
│ └── js
│ ├── plugins.js
│ └── script.js
└── templates
├── admin
│ └── index.html
├── errors
│ ├── 404.html
│ └── 500.html
├── forms
│ ├── login.html
│ └── register.html
├── layouts
│ └── main.html
└── pages
├── placeholder.about.html
└── placeholder.home.html
- Clone the repo
$ git clone https://github.com/aaronleetw/flask-boilerplate.git
$ cd flask-boilerplate
- Initialize and activate a virtualenv:
$ python -m venv env
$ source env/bin/activate
- Install the dependencies:
$ pip install -r requirements.txt
- Run the development server:
$ python app.py
- Navigate to http://localhost:5000
The two guides down below MIGHT NOT WORK (I DID NOT CHECK).
- Signup for Heroku
- Login to Heroku and download the Heroku Toolbelt
- Once installed, open your command-line and run the following command -
heroku login
. Then follow the prompts:
Enter your Heroku credentials.
Email: michael@mherman.org
Password (typing will be hidden):
Could not find an existing public key.
Would you like to generate one? [Yn]
Generating new SSH public key.
Uploading ssh public key /Users/michaelherman/.ssh/id_rsa.pub
- Activate your virtualenv
- Heroku recognizes the dependencies needed through a requirements.txt file. Create one using the following command:
pip freeze > requirements.txt
. Now, this will only create the dependencies from the libraries you installed using pip. If you used easy_install, you will need to add them directly to the file. - Create a Procfile. Open up a text editor and save the following text in it:
web: gunicorn app:app --log-file=-
Then save the file in your applications root or main directory as Procfile (no extension). The word "web" indicates to Heroku that the application will be attached to the HTTP routing stack once deployed.
- Create a local Git repository (if necessary):
$ git init
$ git add .
$ git commit -m "initial files"
- Create your app on Heroku:
$ heroku create <name_it_if_you_want>
- Deploy your code to Heroku:
$ git push heroku master
- View the app in your browser:
$ heroku open
-
You app should look similar to this - http://www.flaskboilerplate.com/
-
Having problems? Look at the Heroku error log:
$ heroku logs
If you plan on working exclusively within PythonAnywhere, which you can, because it provides a cloud solution for hosting and developing your application, you can skip step one entirely. :)
- Sign up for PythonAnywhere, if you haven't already
- Once logged in, you should be on the Consoles tab.
- Clone this repo:
$ git clone git://github.com/realpython/flask-boilerplate.git
$ cd flask-boilerplate
- Create and activate a virtualenv:
$ virtualenv venv --no-site-packages
$ source venv/bin/activate
- Install requirements:
$ pip install -r requirements.txt
- Next, back on PythonAnywhere, click Web tab.
- Click the "Add a new web app" link on the left; by default this will create an app at your-username.pythonanywhere.com, though if you've signed up for a paid "Web Developer" account you can also specify your own domain name here. Once you've decided on the location of the app, click the "Next" button.
- On the next page, click the "Flask" option, and on the next page just keep the default settings and click "Next" again. Once the web app has been created (it'll take 20 seconds or so), you'll see a link near the top of the page, under the "Reload web app" button, saying "It is configured via a WSGI file stored at..." and a filename. Click this, and you get to a page with a text editor.
- Put the following lines of code at the start of the WSGI file (changing "your-username" appropriately)
activate_this = '/home/your-username/flask-boilerplate/venv/bin/activate_this.py'
execfile(activate_this, dict(__file__=activate_this))
- Then update the following lines of code:
from
project_home = u'/home/your-username/mysite'
to
project_home = u'/home/your-username/flask-boilerplate'
from
from flask_app import app as application
to
from app import app as application
- Save the file.
- Go to the website http://your-username.pythonanywhere.com/ (or your own domain if you specified a different one earlier), and you should see something like this - http://www.flaskboilerplate.com/.
Now you're ready to start developing!
Need to PUSH your PythonAnywhere repo to Github?
- Start a bash console
- Run:
$ ssh-keygen -t rsa
- Just accept the defaults, then show the public key:
$ cat ~/.ssh/id_rsa.pub
- Log in to GitHub.
- Go to the "Account settings" option at the top right (currently a wrench and a screwdriver crossed)
- Select "SSH Keys" from the list at the left.
- Click the "Add SSH key" button at top right.
- Enter a title (I suggest something like "From PythonAnywhere" and then paste the output of the previous "cat" command into the Key box.
- Click the green "Add key" button. You'll be prompted to enter your password.
PUSH and PULL away!
- Using Heroku? Make sure you deactivate your virtualenv once you're done deploying:
deactivate
- Need to reactivate? (1) Unix -
source venv/bin/activate
(2) Windows -venv\scripts\activate
- Add your Google Analytics ID to the main.html file
- Add a domain name to Heroku or PythonAnywhere via a CNAME record
- DEVELOP YOUR APP - need help?