{"id":19335707,"url":"https://github.com/buttercms/django-starter-buttercms","last_synced_at":"2025-04-23T00:32:08.104Z","repository":{"id":41420597,"uuid":"420087943","full_name":"ButterCMS/django-starter-buttercms","owner":"ButterCMS","description":"Drop-in proof-of-concept Python/Django app, fully integrated with your ButterCMS account","archived":false,"fork":false,"pushed_at":"2025-04-17T12:41:43.000Z","size":665,"stargazers_count":8,"open_issues_count":0,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-20T23:04:21.822Z","etag":null,"topics":["butter","buttercms","cms","django","python","starter-project"],"latest_commit_sha":null,"homepage":"https://django-starter-buttercms-demo.herokuapp.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ButterCMS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-22T12:20:50.000Z","updated_at":"2025-04-17T12:40:25.000Z","dependencies_parsed_at":"2024-10-11T07:11:54.495Z","dependency_job_id":"228bffc2-1e7b-4da5-980a-660313abc5c1","html_url":"https://github.com/ButterCMS/django-starter-buttercms","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fdjango-starter-buttercms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fdjango-starter-buttercms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fdjango-starter-buttercms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fdjango-starter-buttercms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ButterCMS","download_url":"https://codeload.github.com/ButterCMS/django-starter-buttercms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250348327,"owners_count":21415894,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["butter","buttercms","cms","django","python","starter-project"],"created_at":"2024-11-10T03:08:32.891Z","updated_at":"2025-04-23T00:32:08.094Z","avatar_url":"https://github.com/ButterCMS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Django + ButterCMS Starter Project\n\n\u003e [!IMPORTANT]\n\u003e We officially support Python versions 3.8 to 3.11. This project uses Python 3.11.8 and Django 4.2.20 LTS.\n\nLive demo: [https://django-starter-buttercms-demo.herokuapp.com/](https://django-starter-buttercms-demo.herokuapp.com/)\n\nThis Django starter project fully integrates with dynamic sample content from your ButterCMS account, including main menu, pages, blog posts, categories, and tags, and all with a beautiful, custom theme with already-implemented search functionality. All of the included sample content is automatically created in your account dashboard when you \n[sign up for a free trial](https://buttercms.com/join/) of ButterCMS.\n\n[![Built with Cookiecutter Django](https://img.shields.io/badge/built%20with-Cookiecutter%20Django-ff69b4.svg?logo=cookiecutter)](https://github.com/pydanny/cookiecutter-django/)\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/ButterCMS/django-starter-buttercms/\u0026env[BUTTERCMS_API_TOKEN]=check%20https://buttercms.com/settings)\n\n## 1) Installation\n\nFirst, create a virtual environment and install dependencies by running the \nbelow commands.\n\n```bash\n$ git clone https://github.com/ButterCMS/django-starter-buttercms.git\n$ cd django-starter-buttercms\n$ python3 -m venv butterenv \u0026\u0026 source butterenv/bin/activate\n$ pip install --upgrade pip \u0026\u0026 pip install -r requirements.txt\n```\n\n### 2) Set ButterCMS API Token\n\nTo fetch your ButterCMS content, add your API token as an environment variable. \n\n```bash\n$ echo 'BUTTERCMS_API_TOKEN=your_token' \u003e\u003e .env\n```\n\n### 3) Run Django Local Development Server\n\nTo view the app in the browser, you'll need to run the local development server:\n\n```bash\n$ python manage.py runserver\n```\n\nCongratulations! Your starter project is now live at: [http://localhost:8000/](http://localhost:8000/)\n\n### 4) Deploy on Heroku\n\nOur starter app can be deployed to Heroku with the click of a button:\n\n1. Create a Heroku account at https://signup.heroku.com.\n2. Click the button below and fill in an app name and your Butter API token. Then click \"deploy\".\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/ButterCMS/django-starter-buttercms/\u0026env[BUTTERCMS_API_TOKEN]=check%20https://buttercms.com/settings)\n\n### 5.) Previewing and Draft Changes\n\nYour starter app allows you to preview draft changes made to content in your\nButterCMS.com account by default; to see draft changes, add '?preview=1' to the end of any \nURL (e.g., http://localhost:8000/?preview=1)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuttercms%2Fdjango-starter-buttercms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuttercms%2Fdjango-starter-buttercms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuttercms%2Fdjango-starter-buttercms/lists"}