{"id":17866082,"url":"https://github.com/rnegron/django-project-template","last_synced_at":"2026-02-12T21:30:50.130Z","repository":{"id":38106228,"uuid":"254951037","full_name":"rnegron/django-project-template","owner":"rnegron","description":"A Django template using my favorite packages","archived":false,"fork":false,"pushed_at":"2025-10-14T16:06:36.000Z","size":417,"stargazers_count":9,"open_issues_count":15,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-20T08:39:02.991Z","etag":null,"topics":["django","django-project","django-rest-framework","django-template-project","template-project"],"latest_commit_sha":null,"homepage":"https://raulnegron.me/django-project-template/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rnegron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2020-04-11T20:37:03.000Z","updated_at":"2025-10-14T16:06:42.000Z","dependencies_parsed_at":"2024-04-21T00:19:47.033Z","dependency_job_id":"69f9aade-b13c-47f3-aa3f-87436dd4b374","html_url":"https://github.com/rnegron/django-project-template","commit_stats":null,"previous_names":[],"tags_count":4,"template":true,"template_full_name":null,"purl":"pkg:github/rnegron/django-project-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rnegron%2Fdjango-project-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rnegron%2Fdjango-project-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rnegron%2Fdjango-project-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rnegron%2Fdjango-project-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rnegron","download_url":"https://codeload.github.com/rnegron/django-project-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rnegron%2Fdjango-project-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29381742,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T20:34:40.886Z","status":"ssl_error","status_checked_at":"2026-02-12T20:23:00.490Z","response_time":55,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["django","django-project","django-rest-framework","django-template-project","template-project"],"created_at":"2024-10-28T09:26:46.440Z","updated_at":"2026-02-12T21:30:50.125Z","avatar_url":"https://github.com/rnegron.png","language":"Python","readme":"# Raúl's Django project template\n\nWhen I get an idea for a backend project, I want to get up and running quickly with all my favorite packages. Hence this template repository!\n\n## About\n\nInspired by [Sergio Mattei's](https://matteing.com/) \"Shipping Projects at Lightning Speed with Django and NextJS\" talk at [Fullstack Nights](https://fullstacknights.com/about/), as well as [José Padilla's](https://github.com/jpadilla/django-project-template) own project template.\n\n## Features\n\n* Most recent supported Python version (3.13)\n* Latest Django LTS version (5.2)\n* [uv](https://docs.astral.sh/uv/) as an alternative to `pip` and `pipenv`\n* Type hints using `mypy` and `django-stubs`\n* Tests and linting with GitHub CI\n* Containerization with Docker\n* A `docker-compose` setup for easy development using the latest Postgres major version supported by Heroku (16)\n* Static file serving with [WhiteNoise](https://whitenoise.readthedocs.io/en/stable/)\n* Deployment to [Heroku](https://dashboard.heroku.com/) using containers\n* Testing with [pytest-django](https://pytest-django.readthedocs.io/en/latest/index.html)\n* Aggressive [pre-commit](https://pre-commit.com/) hooks with [Ruff](https://docs.astral.sh/ruff/) for fast linting and formatting\n* [Conventional Commits](https://www.conventionalcommits.org/) enforcement via [Commitizen](https://commitizen-tools.github.io/commitizen/)\n* Django-specific pre-commit hooks (system checks, migration checks)\n* Alternative settings layout within a top-level config folder\n* [Custom user model](https://docs.djangoproject.com/en/5.2/topics/auth/customizing/#auth-custom-user) with no username (only email/password)\n* [Sentry](https://sentry.io) support for error tracking\n* [Atomic Requests](https://docs.djangoproject.com/en/5.2/ref/settings/#atomic-requests) in production\n* [Celery](https://docs.celeryproject.org/en/stable/index.html) asynchronous task management with [Redis](https://redis.io) as the transport\n* [Django Celery Beat](https://django-celery-beat.readthedocs.io/en/latest/) for periodic tasks management from the Django Admin\n* [htmx](https://htmx.org/) support via `django-htmx` for AJAX and other tools in HTML\n* [Tailwind CSS v4](https://tailwindcss.com/) support via `django-tailwind` for webpage styling\n* [Alpine.js](https://alpinejs.dev/) support via base template `\u003cscript\u003e` tag for small interactivity\n\n## Manual Quickstart\n\nI recommend checking out [pipx](https://github.com/pipxproject/pipx) for isolating management commands like `django-admin` when working outside a virtual environment.\n\n\n```bash\npipx install 'django==5.2'\n```\n\n```bash\ndjango-admin startproject \\\n    --template=https://github.com/rnegron/django-project-template/archive/main.zip \\\n    --name=docker-entrypoint.sh,pytest.ini \\\n    --extension=py,md,toml \\\n    --exclude=node_modules \\\n    project_name_here\n```\n\n```bash\ncd project_name_here\n```\n\n```bash\nuv sync\n```\n\n```bash\ncp .env.example .env\n```\n\n```bash\nuv run pre-commit install\n```\n\n```bash\nuv run python manage.py check\n```\n\nIf not using Docker, you will need to provide your own Postgres database and add the connection URL to the `.env` file.\n\n\n## Docker Quickstart\n\n```bash\npipx install 'django==5.2'\n```\n\n```bash\ndjango-admin startproject \\\n    --template=https://github.com/rnegron/django-project-template/archive/main.zip \\\n    --name=docker-entrypoint.sh,pytest.ini \\\n    --extension=py,md,toml \\\n    --exclude=node_modules \\\n    project_name_here\n```\n\n```bash\ncd project_name_here\n```\n\n```bash\ncp .env.example .env\n```\n\n```bash\ndocker-compose up --detach --build\n```\n\nThe API should be live at [http://localhost:8000](http//localhost:8000). A super user for the Django Admin is created automatically using fixtures when using the Docker quickstart method.\n\n```\n    email: admin@example.com\n    password: password123\n```\n## Deploy with Heroku\n\nLog in to your Heroku account with their CLI and set up your repository to track your Heroku app. Then,\n\n* `heroku stack:set container`\n* `git push heroku main`\n\nMore information: [Heroku docs](https://devcenter.heroku.com/articles/build-docker-images-heroku-yml).\n\n## Track errors with Sentry\n\nSimply add your Sentry DSN to the `.env` file.\n\nMore information: [Sentry docs](https://sentry.io/for/django/).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frnegron%2Fdjango-project-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frnegron%2Fdjango-project-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frnegron%2Fdjango-project-template/lists"}