Variables d'environnement

Les variables d'environnement fournissent à votre application ses secrets et sa configuration (URL de base de données, clés d'API…) sans les inscrire dans votre code.

Ajouter une variable

Deux moments possibles.

À l'import du projet. Dans le panneau de configuration qui s'ouvre quand vous choisissez un dépôt, la section Variables d'environnement vous laisse en déclarer autant que nécessaire. Elles sont enregistrées avant la première compilation, ce qui compte pour celles qui sont lues pendant celle-ci (voir plus bas).

À tout moment ensuite. Sur la page de votre projet, dans la section Variables d'environnement, renseignez un nom et une valeur, puis validez.

Un nom ne peut contenir que des lettres, des chiffres et des underscores, et ne peut pas commencer par un chiffre :

DATABASE_URL
STRIPE_SECRET_KEY
API_BASE_URL

Les valeurs sont en écriture seule

Pour des raisons de sécurité, une valeur ne peut plus être affichée après enregistrement — seulement remplacée ou supprimée. Kavio n'affiche jamais la valeur d'une variable existante, même à vous.

Application des changements

Ajouter, modifier ou supprimer une variable redémarre votre application pour qu'elle prenne en compte la nouvelle configuration.

Variables lues pendant la compilation

Vos variables sont disponibles à deux instants : au démarrage de votre application, et pendant sa compilation.

Cette distinction a une conséquence directe. Certains frameworks remplacent la variable par sa valeur au moment de la compilation, une fois pour toutes — c'est le cas des noms préfixés NEXT_PUBLIC_ (Next.js), VITE_ (Vite) ou REACT_APP_ (Create React App). Pour celles-là, redémarrer l'application ne suffit pas : la valeur est déjà figée dans le code compilé.

Si vous modifiez une variable de ce type sur un projet déjà en ligne, lancez un Rebuild depuis la page du projet. Déclarée dès l'import, en revanche, elle est prise en compte sans rien faire de plus.