A quick way to start a new Django Project. Projects come ready to run on Heroku.

note: you will need Virtualenv and Git installed. If you want to put your project on Heroku, you will also need to install the Heroku toolbelt and have a Heroku account to which you have uploaded your ssh key and are logged in (heroku login).

1. Clone this repository
   1. git clone https://github.com/jackm321/djangoStarter.git
2. Change the name of the directory you just cloned from djangoStarter to the name you want for your project
   1. mv djangoStarter new_project_name
3. cd into the project directory
   1. cd new_project_name
4. Run the initialization script
   1. python setup.py
5. Create the virtual environment
   1. virtualenv venv --distribute
6. Activate the virtual environment
   1. Mac/Linux: source venv/bin/activate
   2. Windows: venv\scripts\activate.bat
7. Install required Python packages
   1. pip install -r requirements.txt
8. run server
   • Mac/Linux(port 5000): foreman start
   • Windows(port 8000): python manage.py runserver
9. connect to server by default set to http://0.0.0.0:5000 if doesn't work, check the command line prompt after starting server: Listening at: http://0.0.0.0:5000

1. create a new git repository
   1. git init
2. create an initial commit
   1. git add . && git commit -m "initial commit"
3. move it over to your github
   1. git remote set-url origin https://github.com/your_user_name/new_repo_name.git

1. create a new Heroku app
   1. heroku create [new_project_name]
      1. note that project names are optional when creating a new Heroku project but if you do specify one then it must be unique accross all Heroku users
2. push your code to Heroku
   1. git push heroku master
3. go visit your project on Heroku
   1. heroku open