utsengar/flask-boilerplate

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
│   │   ├── 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-webfont.eot
│   │   ├── fontawesome-webfont.svg
│   │   ├── fontawesome-webfont.ttf
│   │   ├── fontawesome-webfont.woff
│   │   └── FontAwesome.otf
│   ├── 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.0.6.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
│   │   ├── main.html
│   │   └── form.html
│   └── pages
│       ├── placeholder.about.html
│       └── placeholder.home.html
└── screenshots
    ├── pages.png
    └── forms.png

Screenshots

Quick Start

Clone the repo

 $ git clone git@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: 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.
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) 
```

Create a local Git repository:

 $ 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
 $ heroku ps:scale web=1

Check to make sure your app is running:
```
 $ heroku ps
```
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. 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. :)
Sign up for PythonAnywhere, if you haven't already
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.

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, click the link for Dashboard, then the link for Web.
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 template.html file
Add a domain name to Heroku or PythonAnywhere via a CNAME record
DEVELOP YOUR APP - need help?
Sign up for Github, create a new repo, push your app.

utsengar / flask-boilerplate