Création et développement d'une nouvelle app avec React

Initialisation

2 approches possibles :

Création d’un nouveau repo
Ajout dans un repo existant

Dans les 2 cas, il faut :

Partir de https://github.com/opendigitaleducation/ode-react-boilerplate
- Cloner le repo qui contient une app React configurée
Rapatrier le backend dans un sous-dossier backend

Dev Local

Pré-requis :

Faire tourner un springboard ou ode-dev-server en local sur le port localhost:8090
Dans l’appli React, configurer le proxy de vite.config.ts avec les routes nécessaires au développement.

// Exemple
"/blog": proxyObj,
"/explorer": proxyObj,
"/xxx": proxyObj

Dev Remote

⚠️ Pour du développement front, il est possible de ne pas utiliser un springboard local et d’accéder directement au backend sur un environnement de recette, comme ci-dessous :

Dans l’appli React, ajouter un fichier .env à la racine (ce fichier est ignoré par git)
Configurer le fichier suivant avec les informations de l’utilisateur connecté sur la recette (ex: isabelle.polonio/EasyDemo)

VITE_XSRF_TOKEN=<XSRF-TOKEN-GOES-HERE>
VITE_ONE_SESSION_ID=<ONE-SESSION-ID-GOES-HERE>
VITE_LOCALHOST=<URL-LOCALHOST>
VITE_RECETTE=<URL-RECETTE>

Il est possible pour le développement front, d’utiliser le localhost et la recette, notamment pour les CSS. Dans ce cas, remplacer la ligne

"^/(?=assets|theme|locale|i18n|skin)": proxyObj,

par ceci dans la conf du proxy de vite.config.ts

"^/(?=assets)": {
   target: envs.VITE_LOCALHOST || "http://localhost:8090",
   changeOrigin: false
},
"^/(?=theme|locale|i18n|skin)": proxyObj,