---
title: "Prévisualiser avant la production : la doc de while.sh"
url: https://while.sh/fr/docs/briques/preview/
updated: 2026-11-09
---

# Prévisualisations

Une prévisualisation montre une nouvelle version à son adresse, avec ses propres bases, avant la production. Elle disparaît d'elle-même.

> Vous, à votre agent : Montre-moi la nouvelle page avant de la mettre en ligne.

## Ce que votre agent écrit

Votre agent l'écrit dans while.yaml, à la racine de votre appli :

```yaml titre="while.yaml"
environments:
  preview:
    from: production
    ttl_hours: 24
```

## Quand vous en servir

Servez-vous-en pour essayer une branche avant la production. Une personne y pointe ce qui ne va pas avec le widget `<script src="/__while/retours.js" defer>`, et votre agent le lit avec l'outil `list_page_notes`.

## Comment ça marche

Une prévisualisation reprend l'image de la production, avec ses propres variables, ses bases et son adresse, et disparaît d'elle-même. Ses bases naissent vides, ou copiées de la production sur demande.

## Ce qu'il faut savoir

Sans `copy_database: true`, les bases naissent vides (initdb) : c'est voulu, pas une panne. Copier les données de la production demande `create_preview` `{ copy_database: true }` et le droit `data.backup` sur chaque base de la production ; sans ce droit, la réponse est un 403 qui le nomme.

Une base copiée naît de la dernière sauvegarde de la production, journal rejoué jusqu'au dernier point archivé : il faut une minute ou plus selon sa taille. Si la production n'a pas encore de sauvegarde complète, la base naît vide. Les buckets S3 d'une prévisualisation sont neufs et vides, et `ttl_hours` fixe sa durée de vie.

## Les outils MCP de votre agent

Votre agent s'en occupe avec les outils `create_preview` et `destroy_environment`.

## Guides

- [Voir chaque nouvelle version avant la production, comme un environnement de recette, depuis votre agent IA](/fr/guides/previsualisation-par-branche/)