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, and the Twitter 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!

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
├── app.py
├── config.py
├── error.log
├── forms.py
├── models.py
├── requirements.txt
├── static
│   ├── css
│   │   ├── boostrap-responsive.css
│   │   └── bootstrap.css
│   ├── img
│   │   ├── glyphicons-halflings-white.png
│   │   └── glyphicons-halflings.png
│   └── js
│       ├── libs
│       │   ├── bootstrap.min.js
│       │   ├── jquery.min.js
│       │   └── modernizr-2.0.6.min.js
│       ├── plugins.js
│       └── script.js
└── templates
    ├── 404.html
    ├── 500.html
    ├── index.html
    ├── login.html
    ├── register.html
    └── template.html

Quick Start

1. Clone the repo

    $ git clone [email protected]:mjhea0/flask-boilerplate.git
    $ cd flask-boilerplate
   

2. Initialize and activate a virtualenv:

    $ virtualenv --no-site-packages env
    $ source env/bin/activate
   

3. Install the dependencies:

    $ pip install -r requirements.txt
   

4. Run the development server:

    $ python app.py
   

5. Navigate to http://localhost:5000

Deploying to Heroku

1. Signup for Heroku

2. Login to Heroku and download the Heroku Toolbelt

3. Once installed, open your command-line and run the following command - heroku login. Then follow the prompts:

    Enter your Heroku credentials.
    Email: [email protected]
    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
   

4. Activate your virtualenv

5. 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.

6. Create a Procfile. Open up a text editor and save the following text in it:

    web: python run.py
   

   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.

7. Update your run.py file. On your local machine, the application runs on port 5000 by default. On Heroku, the application must run on a random port number specified by Heroku. We will identify this port number by reading the environment variable 'PORT' and passing it to app.run:

    # run.py
    
    
    import os
    
    from flasktaskr import app
    
    port = int(os.environ.get('PORT', 5000))
    app.run(host='0.0.0.0', port=port, debug=False) 
   

8. Create a local Git repository:

    $ git init
    $ git add .
    $ git commit -m "initial files"
   

9. Create your app on Heroku:

    $ heroku create <name_it_if_you_want>
   

10. Deploy your code to Heroku:

     $ git push heroku master
     $ heroku ps:scale web=1
    

11. Check to make sure your app is running:

     $ heroku ps
    

12. View the app in your browser:

     $ heroku open
    

13. You app should look similar to this - http://www.flaskboilerplate.com/

14. Having problems? Look at the Heroku error log:

     $ heroku logs
    

Deploying to PythonAnywhere

1. Install Git and Python - if you don't already have them, of course. Note=> 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. :)

2. Sign up for PythonAnywhere, if you haven't already

3. Once logged in, you should be on the Consoles tab. Under the header "Start a new console:" click the link for Bash, which will open a new terminal.

4. Clone this repo:

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

5. Create and activate a virtualenv:

    $ virtualenv venv --no-site-packages
    $ source venv/bin/activate
   

6. Install requirements:

    $ pip install -r requirements.txt
   

7. Next, click the link for Dashboard, then the link for Web.

8. 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.

9. 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.

10. 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))
    

11. 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
    

12. Save the file.

13. 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?

1. Start a bash console

2. Run:

    $ ssh-keygen -t rsa
   

3. Just accept the defaults, then show the public key:

    $ cat ~/.ssh/id_rsa.pub
   

4. Log in to GitHub.

5. Go to the "Account settings" option at the top right (currently a wrench and a screwdriver crossed)

6. Select "SSH Keys" from the list at the left.

7. Click the "Add SSH key" button at top right.

8. Enter a title (I suggest something like "From PythonAnywhere" and then paste the output of the previous "cat" command into the Key box.

9. Click the green "Add key" button. You'll be prompted to enter your password.

PUSH and PULL away!

What's next?

1. Using Heroku? Make sure you deactivate your virtualenv once you're done deploying: deactivate
2. Need to reactivate? (1) Unix - source venv/bin/activate (2) Windows - venv\scripts\activate
3. Add your Google Analytics ID to the template.html file
4. Add a domain name to Heroku or PythonAnywhere via a CNAME record
5. DEVELOP YOUR APP - need help?
6. Sign up for Github, create a new repo, push your app.

Learn More

1. Getting Started with Python on Heroku
2. PythonAnywhere - Help
3. Flask Documentation
4. Flask Extensions
5. Real Python for the Web :)