Better Onboarding

[BrandonShar]

Getting started with Inertia Django has been raised a few times as an issue for adoption and it would be great to improve that experience. We saw the same issues over in Inertia Rails and have since added generators to help with scaffolding new apps.

Are there particular Django libraries that do have better onboarding we could mimic? Maybe we could reach out to @Louxsdon to better integrate (or just link to) the great django-breeze library.

Tagging @eddyojb88 and @sopelj since they both raised this in the original thread!

[BrandonShar]

Looks like @SarthakJariwala also created a template based installer here: https://github.com/SarthakJariwala/django-vite-inertia from back in issue #3

[BrandonShar]

@mujahidfa also created an example repo here: https://github.com/mujahidfa/inertia-django-vite-vue-minimal

[eddyojb88]

@BrandonShar

Django Channels has decent documentation. I like the conciseness of the documentation for inertia so far but for me what makes a package like Channels a viable option to explore is detailed sections on:

• How it works with usage considerations
• How authentication fits in
• Security considerations
• Deployment to production - an example

The aspect that scared me off for django-inertia / django-breeze for a project that I needed to move fast on for was the production notes - I wasn't sure what the sparness of this section meant for me down the line and so I ended up going for django + htmx at the time.

E.g. in Django-breeze, production section , it wasn't clear to me as a new user why we need 2 servers for development but in production it can all be served by one server. Some notes to demystify this would be great.

The ideal from a new user perspective would be to integrate the django breeze in to django-inertia.

[SarthakJariwala]

Thanks for linking the template installer @BrandonShar - I hope it serves as a good starting point for inertia-django.
(It's not quite what rails inertia installer is but I have some ideas that I'm exploring on that front.)

To expand on @eddyojb88's point, I think it would be nice if inertia-django had a docs site similar to inertia-rails. That would provide the room for discussing different things like detailed setup instructions, authentication, deployment, etc.
The README-only documentation feels a little light from a new user's perspective. I'm happy to work on setting up docs. :-)