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 https://forgepackages.com/quickstart.py | 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).
- Find/authorize your GitHub repo
- Check the "Wait for CI to pass before deploy" box, and click "Enable Automatic Deploys"
- 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.