flask-boilerplate: A CSS repository from LiHanQing

Welcome

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, Fabric, Coverage, and the Bootstrap 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!

Designed for the Real Python course.

Preview the skeleton app here - http://www.flaskboilerplate.com/

EXAMPLE APP: http://flasktaskr.herokuapp.com/

What is Flask? Flask is a microframework for Python based on Werkzeug and Jinja2.

Project Structure

├── Procfile
├── Procfile.dev
├── README.md
├── app.py
├── config.py
├── error.log
├── forms.py
├── models.py
├── requirements.txt
├── static
│   ├── css
│   │   ├── bootstrap-3.0.0.min.css
│   │   ├── bootstrap-theme-3.0.0.css
│   │   ├── bootstrap-theme-3.0.0.min.css
│   │   ├── font-awesome-3.2.1.min.css
│   │   ├── layout.forms.css
│   │   ├── layout.main.css
│   │   ├── main.css
│   │   ├── main.quickfix.css
│   │   └── main.responsive.css
│   ├── font
│   │   ├── FontAwesome.otf
│   │   ├── fontawesome-webfont.eot
│   │   ├── fontawesome-webfont.svg
│   │   ├── fontawesome-webfont.ttf
│   │   └── fontawesome-webfont.woff
│   ├── 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
│       ├── libs
│       │   ├── bootstrap-3.0.0.min.js
│       │   ├── jquery-1.10.2.min.js
│       │   ├── modernizr-2.6.2.min.js
│       │   └── respond-1.3.0.min.js
│       ├── plugins.js
│       └── script.js
└── templates
    ├── errors
    │   ├── 404.html
    │   └── 500.html
    ├── forms
    │   ├── forgot.html
    │   ├── login.html
    │   └── register.html
    ├── layouts
    │   ├── form.html
    │   └── main.html
    └── pages
        ├── placeholder.about.html
        └── placeholder.home.html

Screenshots

Quick Start

Clone the repo

$ git clone https://github.com/mjhea0/flask-boilerplate.git
$ cd flask-boilerplate

Initialize and activate a virtualenv:

$ virtualenv --no-site-packages 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

Deploying to Heroku

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

Deploying to PythonAnywhere

Install Git and Python - if you don't already have them, of course.

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/mjhea0/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'

project_home = u'/home/your-username/flask-boilerplate'

from

from flask_app import app as application

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!

What's next?

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?

LiHanQing/flask-boilerplate