cookiecutter-django VS docker-django-example

I found that this django setup was an excellent starting point:

https://github.com/cookiecutter/cookiecutter-django

Falco, in contrast to cookiecutter-django, aims to enhance the Django developer experience beyond project generation. It provides a CRUD generator and guides on various Django topics such as task queues, multitendency, deployment, realtime, etc.

It's not a tutorial but it's a resource to generate a Python+Django project with celery and Dockerfiles and other things you mentioned : https://github.com/cookiecutter/cookiecutter-django

There are very useful packages for bootstrapping your Django projects in minutes such as django-cookiecutter and djangox. If you are a seasoned developer I'd highly recommend using one of these instead of what I'm going to show here. But if you are struggling with the project structure of these packages as a beginner to intermediate Django developer and looking to structure your own Django projects in a better way, I have created a lightweight setup that deals with the basics of setting up a Django project with PostgreSQL as database and TailwindCSS as our styling library.

And so, the idea for cookiecutter-django-lite came into existence. I am an absolute fan of https://github.com/cookiecutter/cookiecutter-django - but for a lot of use cases this template is an overkill so I thought a barebones version of this will be superuseful - and that's how the idea of cookiecutter-django-lite was born.

Consider taking a look at cookiecutter to generate projects from templates. There is also cookiecutter-django. As for your environment variables you should have an example .env file containing all the environment variables required by your project (without setting them) that can be safely pushed into your repository for you and other developers to copy into the actual .env file that'll be used by your project (add this file to .gitignore)

I'm obviously biased, so take what I say with a grain of salt, but I also probably know more about this space than ~anyone else. I'd say that your characterization is pretty accurate. There are many similar products to Pegasus (you can find a pretty comprehensive list here: https://github.com/smirnov-am/awesome-saas-boilerplates) but most of them are either more focused on infrastructure/setup (e.g. cookiecutter-django or - as you noted - far less mature/maintained (most of the others on that list).

I followed a lot of the guidance found in this "template" here: https://github.com/cookiecutter/cookiecutter-django

If you understand all that and just want to get started as quickly as possible, use a project generator such as cookiecutter-django or API Bakery. Note that I'd avoid using these until you have a solid grasp of Django otherwise you'll have no idea what's going on.

There's nothing to pretend about and there's no bug because both versions of the code do the same thing, the 2nd version is just easier to read and requires less `uv` knowledge to know what happens when `uv lock` runs with an invalid lock file. The history is in the HN comment I wrote and git history.

It doesn't make sense to leave the original code in the blog post and then write a wall of text to explain how it worked fine but here's a modified version for clarity. Both versions of the code have the same outcome which is ensuring there's a valid lock file before syncing.

Here's the commits https://github.com/nickjj/docker-flask-example/commit/d1b7b9... and https://github.com/nickjj/docker-django-example/commit/a12e2... btw.

If anyone is looking for examples on using uv with Docker, I have Flask and Django example apps at https://github.com/nickjj/docker-flask-example and https://github.com/nickjj/docker-django-example.

It prevents uv from making a virtual environment and does some optimizations like compiling byte code once when you're dependencies get installed.

Congrats on the release to the Django community!

If anyone is curious, I updated my Django / Docker starter kit app to use Django 5.0 at: https://github.com/nickjj/docker-django-example

It pulls together gunicorn, Celery, Redis, Postgres, esbuild and Tailwind with Docker Compose. It's set up to run in both development and production.

- https://github.com/nickjj/docker-django-example

For example I edit the regular non-lock file and then run ./run pip3:install from my host which handles the above. A repo with an example Django project in Docker can be found here https://github.com/nickjj/docker-django-example. There's a pip3-install script in the bin/ directory, you can replace that with Poetry commands instead.

Currently, I'm using a modified version of this Docker setup (https://github.com/nickjj/docker-django-example) to work locally and build/deploy a production image. However, using PyCharm as my IDE, the development process is incredibly slow, especially when adding or removing Python packages. It takes at least 3 minutes to rebuild the Docker image after adding a package, and PyCharm has to update its index. Additionally, PyCharm's inspector sometimes gets confused about which packages are already installed based on the requirements.txt.

If anyone is interested I updated my Django / Docker starter project for 4.2: https://github.com/nickjj/docker-django-example

Lots of handy stuff in this Django and Docker example project https://github.com/nickjj/docker-django-example He does a good course about Docker too.

If you're using Docker with a Debian based image you only need to apt install libpq-dev and you're good to go, it only needs to exist in your Docker image not your VPS directly. I've been using it for years. Here's a working example if you want to poke around https://github.com/nickjj/docker-django-example.