Paramètres

Chaque réglage que lit le tableau de bord, sa valeur par défaut, le port, et comment les modifier avec Docker et sans.

Les paramètres

Chaque réglage est facultatif : le tableau de bord fonctionne sans aucun d'eux.

Variable	Par défaut	Rôle
`NEXT_PUBLIC_DEMO_MODE`	`false`	`true` affiche les identifiants de démonstration sur la page de connexion, les remplit, et affiche un sélecteur de couleur flottant. Laissez-le désactivé pour votre propre produit.
`BUILD_STANDALONE`	vide	`true` construit un serveur autonome dans `.next/standalone`. Le `Dockerfile` la définit pour vous. Laissez-la vide pour `yarn start`.

Mode démo

Le port

Le tableau de bord répond sur le port 3030. Ce n'est pas une variable : les scripts dev et start de package.json passent -p 3030, et l'image Docker définit PORT=3030. Pour utiliser un autre port le temps d'un lancement :

Comment vous la lancez	Sur le port 3041
Docker	`docker run -p 3041:3030 financial-dashboard`, en changeant seulement le nombre à gauche de `-p`
Serveur de développement	`yarn dev -p 3041`
Build de production	`yarn start -p 3041`

Un port est déjà utilisé

Sans Docker

Copiez .env.example vers .env.local et modifiez les valeurs là. Gardez .env.example tel quel, comme liste de ce qui existe.

Terminaldans dashboard-template-1

cp .env.example .env.local

.env.local

NEXT_PUBLIC_DEMO_MODE=true

Avec Docker

Le build de l'image ne lit pas les fichiers .env ni .env.local. Passez plutôt chaque valeur comme argument de build :

Terminaldans dashboard-template-1

docker build -t financial-dashboard --build-arg NEXT_PUBLIC_DEMO_MODE=true .

Quand une modification prend effet

Les valeurs qui commencent par NEXT_PUBLIC_ sont compilées dans le JavaScript que le navigateur charge lors de la construction de l'application. En modifier une ne change rien tant que l'application n'est pas reconstruite :

Comment vous la lancez	Après avoir modifié une valeur
`yarn dev`	Arrêtez le serveur et relancez `yarn dev`.
`yarn build` et `yarn start`	Relancez `yarn build`, puis `yarn start`.
Docker	Reconstruisez l'image avec la valeur en `--build-arg`, puis démarrez un nouveau conteneur.
Vercel	Modifiez-la dans les Environment Variables du projet et redéployez.

Ne mettez jamais de secret dans une valeur NEXT_PUBLIC_ : chaque visiteur peut la lire dans le code de la page. Les clés de vos propres services doivent rester sur votre serveur.

Le build standalone

Avec BUILD_STANDALONE=true, yarn build produit un serveur qui n'a pas besoin de node_modules, rangé dans .next/standalone. Le Dockerfile l'utilise pour garder l'image petite. yarn start n'est pas prévu pour ce type de build et avertit "next start" does not work with "output: standalone" configuration. Laissez la variable vide, sauf si vous copiez vous-même le dossier standalone sur un serveur.