---
title: "Guides — les recettes, une tâche à la fois"
source: docs/guides/README.md
url: https://nodefony.github.io/nodefony-core/docs/guides/
---


> 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.

```nodefony-cards
[
  { "icon": "⚙️", "title": "Configuration", "href": "configuration/", "featured": true,
    "desc": "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.",
    "meta": "commence par là" },
  { "icon": "🏗️", "title": "Générer du code", "href": "generer-du-code/",
    "desc": "`nodefony create` : sept types d'objets, un aperçu avant d'écrire quoi que ce soit, et le pilotage depuis un agent.",
    "meta": "ne pas écrire ce qu'une commande produit" },
  { "icon": "⚛️", "title": "Frontend React", "href": "frontend-react/",
    "desc": "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.",
    "meta": "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.

```nodefony-cards
[
  { "icon": "🗃️", "title": "Persistance", "href": "persistence/", "featured": true,
    "desc": "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.",
    "meta": "le tableau de bord de vos données" },
  { "icon": "🗝️", "title": "Stockage de session", "href": "session-storage/",
    "desc": "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.",
    "meta": "le choix qui décide de votre scaling" },
  { "icon": "⚖️", "title": "Parité des adaptateurs", "href": "parite-des-adaptateurs/",
    "desc": "SQL ou MongoDB : ce que les bancs prouvent identique, les écarts assumés entre moteurs — et ce qu'aucun banc ne prouve encore.",
    "meta": "à lire avant de choisir son moteur" }
]
```

## 🚢 Mettre en production

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

```nodefony-cards
[
  { "icon": "🐳", "title": "Docker & cloud-native", "href": "docker-cloud-native/", "featured": true,
    "desc": "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.",
    "meta": "à lire avant le premier déploiement" },
  { "icon": "🛡️", "title": "Reverse-proxy", "href": "reverse-proxy/",
    "desc": "nginx, HAProxy, Traefik : la configuration se DÉRIVE de l'application — ports, domaines, statiques des modules, taille de corps, inactivité WebSocket.",
    "meta": "et la moitié côté application, sans laquelle le proxy parle dans le vide" },
  { "icon": "☸️", "title": "Kubernetes", "href": "kubernetes/",
    "desc": "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.",
    "meta": "après docker-cloud-native, qui donne le modèle et l'image" },
  { "icon": "🔧", "title": "Variables d'environnement", "href": "variables-environnement/",
    "desc": "Chaque variable que le framework et ses modules lisent, son rôle, son défaut quand elle manque, et où la poser en production.",
    "meta": "page générée depuis le code — en écrivant le ConfigMap" },
  { "icon": "👯", "title": "Deux paquets nodefony", "href": "deux-paquets-nodefony/",
    "desc": "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.",
    "meta": "quand `nodefony` échoue là où `npm run dev` réussit" },
  { "icon": "🔌", "title": "Étendre le framework", "href": "etendre/",
    "desc": "Les quatorze endroits où brancher votre implémentation — authentification, stockages, bus temps réel — sans modifier une ligne du framework.",
    "meta": "huit sur la seule sécurité" },
  { "icon": "🤝", "title": "Compatibilité", "href": "compatibilite/",
    "desc": "Ce qui casse en montant de version, ce que la garantie couvre vraiment, et comment une dépréciation se signale dans votre éditeur.",
    "meta": "avant de monter de version" },
  { "icon": "⬆️", "title": "Monter de version", "href": "montee-de-version/",
    "desc": "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.",
    "meta": "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](../tutoriels/premiere-application/)                   |
| Comment ça marche **dedans** — le boot, le pipeline, l'injection | [l'architecture](../architecture/)                           |
| L'API d'une brique précise (routes, sessions, firewall…)         | la documentation de son module                                        |
| Définir des routes, les décorateurs                              | [`framework`](../modules/framework/routing/) |
| WebSocket : actions, canaux, protocole                           | [`realtime`](../modules/realtime/)     |
| Éprouver ce que vous écrivez                                     | [`core` — tests](../modules/core/testing/)                  |

📖 [Lexique général](../lexique/) du framework.