Guides — les recettes, une tâche à la fois

stablemis à jour 2026-05-21

Quinze recettes, une tâche chacune. On suit, on obtient un résultat. Ce n’est ni un tutoriel (qui vous prend par la main du début à la fin) ni de l’architecture (qui explique ce qui se passe dessous) : un guide répond à une question précise, celle que vous vous posez maintenant.

🚀 Construire#

Ce qu’on fait les premiers jours : régler l’application, la faire grandir, lui donner une interface.

Configuration Un fichier racine qui grandit par composition, et un seul lecteur de l'environnement. Le réglage qui ne prend pas vient presque toujours d'ici. commence par là Générer du code nodefony create : sept types d'objets, un aperçu avant d'écrire quoi que ce soit, et le pilotage depuis un agent. ne pas écrire ce qu'une commande produit Frontend React Greffer une interface React 19 sur un module existant : deux serveurs en développement, un seul en production, et le rechargement à chaud entre les deux. React · Vue · Angular · Svelte

🗄️ Ranger ses données#

Où vivent les données, qui décide, et ce qui change quand il y a plusieurs pods.

Persistance Déclarez votre infrastructure — une ou deux URL — et le framework dérive où va chaque brique. La matrice dit exactement ce que chaque backend porte. le tableau de bord de vos données Stockage de session Le mécanisme d'inversion de contrôle, les quatre backends livrés, ce que fait le défaut auto — et comment en écrire un sur mesure. le choix qui décide de votre scaling Parité des adaptateurs SQL ou MongoDB : ce que les bancs prouvent identique, les écarts assumés entre moteurs — et ce qu'aucun banc ne prouve encore. à lire avant de choisir son moteur

🚢 Mettre en production#

Le passage du poste au conteneur, et ce qu’on promet à ceux qui installent.

Docker & cloud-native Un process au premier plan, les sondes /livez et /readyz livrées, l'arrêt gracieux — et les pièges qui font perdre les signaux. à lire avant le premier déploiement Reverse-proxy nginx, HAProxy, Traefik : la configuration se DÉRIVE de l'application — ports, domaines, statiques des modules, taille de corps, inactivité WebSocket. et la moitié côté application, sans laquelle le proxy parle dans le vide Kubernetes Les manifests : Deployment, Secret, Service, Ingress, HPA — et les quatre choses qu'on ne devine pas, dont l'identité du pod et le moment des migrations. après docker-cloud-native, qui donne le modèle et l'image Variables d'environnement Chaque variable que le framework et ses modules lisent, son rôle, son défaut quand elle manque, et où la poser en production. page générée depuis le code — en écrivant le ConfigMap Deux paquets nodefony L'application ne démarre pas, ou démarre amputée, et tout ce qu'on inspecte est sain — deux copies du cœur dans un process. Deux commandes pour le voir. quand `nodefony` échoue là où `npm run dev` réussit Étendre le framework Les quatorze endroits où brancher votre implémentation — authentification, stockages, bus temps réel — sans modifier une ligne du framework. huit sur la seule sécurité Compatibilité Ce qui casse en montant de version, ce que la garantie couvre vraiment, et comment une dépréciation se signale dans votre éditeur. avant de monter de version Monter de version Monter les paquets ensemble, puis remettre l'application au niveau : AGENTS.md, skills d'agent et fichiers livrés, qu'un npm install ne refait pas. après avoir lu Compatibilité

🧭 Et si ce n’est pas ici#

Vous cherchez…	Allez plutôt vers
Un parcours complet, de zéro à une application qui répond	le tutoriel
Comment ça marche dedans — le boot, le pipeline, l’injection	l’architecture
L’API d’une brique précise (routes, sessions, firewall…)	la documentation de son module
Définir des routes, les décorateurs	`framework`
WebSocket : actions, canaux, protocole	`realtime`
Éprouver ce que vous écrivez	`core` — tests

📖 Lexique général du framework.