Django + Forge Quickstart

1. Start a new local project

The Forge Quickstart will step you through creating a new project with our starter template. You'll need Python 3, Poetry, Docker, and Git.

# (Terminal)
curl -sSL | python3 - my-project

2. Create a GitHub repo

Once you have a new local project working, you can create an empty GitHub repo, then commit and push.

3. Deploy to Heroku

To deploy on Heroku, first make sure you have a Heroku account and the Heroku CLI installed. You can create everything you need on Heroku with our forge heroku shortcut:

# (Terminal)
forge heroku create <heroku-app-name> --team <heroku-team-name>

After you run the command, you'll need to connect your new Heroku app to your GitHub repo using your browser (it will print out a link for you to use).

  1. Find/authorize your GitHub repo
  2. Check the "Wait for CI to pass before deploy" box, and click "Enable Automatic Deploys"
  3. Click the "Deploy Branch" button to test a deploy (normally it will deploy when you push a new commit)

4. Go build!

At this point you should have completely functional environments for local development and production deployment. And that's a big part of what Forge is designed to help with.

From here, remember that at it's core, you just have a Django app. So the Django documentation is still your friend and you won't find Forge docs for the standard Django features.