id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
30296	Add how-to guide for JavaScript frameworks integration	Maciej Olko	Ahmed Nassar	"Question ""How do I get Django and my JS framework to work together?"" is common question being searched on the Internet {1}{2} so it should be vital to have at least introduction to this topic in Django's documentation.

How-to guide would consist of two parts (B and C original descriptions by Ayeric Augustin {3}):

A. Consider brief introduction how to make JSON response, what is a REST API and link to API creation Django Packages grid?

B. Singe Page App model description — where Django only serves the API

We would need to explain CORS and CSRF in the clearest terms possible. Many devs end up shotgun-debugging CORS or CSRF errors, which always results in insecure deployments. (…) Perhaps a condensed version of Django React SPA Aymeric's blog post {4} could do the job? (…)

C. Description of integrating a modern JS framework with django.contrib.staticfiles 

(…) The docs should at least give the general idea of ""compile your frontend to somewhere Django can find the files, then run collectstatic"".

Discussion on django-developers: https://groups.google.com/d/topic/django-developers/KVAZkRCq9KU/discussion

Related:
* https://fractalideas.com/blog/making-react-and-django-play-well-together/
* https://fractalideas.com/blog/making-react-and-django-play-well-together-hybrid-app-model/
* https://fractalideas.com/blog/making-react-and-django-play-well-together-single-page-app-model/
* https://djangopackages.org/grids/g/api/
* https://djangopackages.org/grids/g/asset-managers/
* https://djangopackages.org/packages/p/django-cors-headers/
* https://code.djangoproject.com/wiki/AJAX

{1} https://stackoverflow.com/questions/41867055/how-to-get-django-and-reactjs-to-work-together
{2} https://stackoverflow.com/questions/28590177/django-back-end-with-a-dynamic-front-end-angularjs
{3} https://groups.google.com/d/msg/django-developers/KVAZkRCq9KU/rt24LMnPCAAJ
{4} https://fractalideas.com/blog/making-react-and-django-play-well-together-single-page-app-model/"	New feature	assigned	Documentation		Normal		javascript, rest, api, assets		Accepted	0	0	0	0	0	0