Django starter project

Get up and running with Django and ButterCMS in under two minutes, with a starter that showcases Pages, Collections, and a Blog engine.

One-Click Deploy: Skip local setup and deploy to Vercel instantly.

Quick start

Install dependencies and run setup commands.

$ git clone https://github.com/ButterCMS/django-starter-buttercms.git
$ cd django-starter-buttercms
$ python3 -m venv butterenv && source butterenv/bin/activate
$ pip install --upgrade pip && pip install -r requirements.txt

Add your API token as an environment variable and run development server

$ echo 'BUTTERCMS_API_TOKEN=your_token' >> .env
$ python manage.py runserver

Local Development: http://localhost:8000/

GitHub Repository: https://github.com/ButterCMS/django-starter-buttercms

What’s included

Feature	Description
Pages & Page Types	Pre-built page templates with drag-and-drop schema definition
Components	Modular content blocks for dynamic landing pages
Collections	Structured data for navigation, testimonials, FAQs
Blog Engine	Full blog with posts, categories, tags, and search
Media CDN	Automatic image optimization via Filestack

Deploy options

Deploy to Heroku

Deploy to Heroku with environment configuration

Resources

GitHub Repository

View source code and contribute

Django Guide

Framework integration guide

Additional reading

• Building an Online Learning Platform with ButterCMS and Django
• The Great Continuum: Getting Starter with the ButterCMS Django Starter Kit
• How Wedding Together Added a Blog to their Django App in 5 Minutes

Next steps

Core Concepts

Learn about Pages, Collections, and Components

API Reference

Explore the full ButterCMS API