@hgdc/docs 0.3.0 → 0.4.1

package/template/.build/reference/cli.md

@@ -1,31 +1,167 @@
-# La commande hgdc-docs
+# CLI
 
-`hgdc-docs` est installée avec le paquet `@hgdc/docs`. Elle se lance depuis le dossier de la doc, ou avec le chemin du dossier en argument.
+Host accepte la CLI Vercel officielle, version 63. Cette page décrit les commandes prises en charge, leurs options et ce qui n’est pas encore pris en charge.
 
-## Commandes
+## Configurer la CLI
 
-| Commande            | Effet                                                                                                      |
-| ------------------- | ---------------------------------------------------------------------------------------------------------- |
-| `hgdc-docs dev`     | Site local sur `http://localhost:4321`, rechargé à chaque modification.                                    |
-| `hgdc-docs build`   | Site statique dans `dist/`, avec la recherche, `llms.txt`, les pages Markdown et le corpus de l’assistant. |
-| `hgdc-docs preview` | Sert le dernier build, pour vérifier avant de pousser.                                                     |
+Host n’utilise pas la connexion par navigateur de la CLI. Chaque commande reçoit l’adresse de l’API par `--api` et la clé par la variable `VERCEL_TOKEN`.
 
-Options : `--port 4000` change le port de `dev` et `preview`, `--help` affiche l’aide.
+```bash
+npm install --global vercel@63
+export VERCEL_TOKEN=ah_…
+vercel --api https://api.host.hgdc.ch deploy
+```
 
-## Variables d’environnement
+Pour ne pas retaper l’adresse, crée un alias dans ton profil de shell :
 
-| Variable         | Rôle                                                                                                                                                                |
-| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `HGDC_DOCS_SITE` | Adresse publique du site (`https://docs.acme.ch`). Rend les liens de `llms.txt` absolus et produit le sitemap. Sur Host, l’adresse de production est reprise seule. |
-| `HGDC_DOCS_OUT`  | Dossier de sortie, `dist/` par défaut.                                                                                                                              |
-| `HGDC_DOCS_API`  | API de l’assistant, `https://docs.hgdc.ch` par défaut.                                                                                                              |
+```bash
+# ~/.bashrc ou ~/.zshrc
+alias vh="vercel --api https://api.host.hgdc.ch"
 
-## Ce que contient dist/
+# Ensuite
+vh deploy --prod
+```
 
-| Fichier                                             | Contenu                                                        |
-| --------------------------------------------------- | -------------------------------------------------------------- |
-| `index.html`, `<page>/index.html`                   | Les pages du site.                                             |
-| `<page>.md`                                         | Chaque page en Markdown.                                       |
-| `llms.txt`, `llms-full.txt`, `.well-known/llms.txt` | L’index et la doc complète pour les agents.                    |
-| `pagefind/`                                         | L’index de la recherche.                                       |
-| `_hgdc/corpus.json`                                 | Le contenu publié, lu par la console pour indexer l’assistant. |
+En PowerShell, dans `$PROFILE` :
+
+```powershell
+function vh { vercel --api https://api.host.hgdc.ch @args }
+```
+
+> **Attention**
+>
+> Sans `--api`, la CLI parle à Vercel. Si une commande te demande de te connecter dans le navigateur, vérifie que l’option est bien présente.
+
+### Options globales
+
+| Option    | Valeur | Rôle                                                                                         |
+| --------- | ------ | -------------------------------------------------------------------------------------------- |
+| `--api`   | URL    | Adresse de l’API : `https://api.host.hgdc.ch`                                                |
+| `--token` | `ah_…` | Clé d’API. Préfère la variable `VERCEL_TOKEN`, qui n’apparaît pas dans l’historique du shell |
+
+### Ce qui n’est pas pris en charge
+
+| Commande ou option  | État                                                                                         |
+| ------------------- | -------------------------------------------------------------------------------------------- |
+| `vercel login`      | Non : la connexion passe par la clé                                                          |
+| `vercel env`        | Pas encore : gère les variables dans la console                                              |
+| `vercel domains`    | Pas encore : gère les domaines dans la console                                               |
+| `vercel logs`       | Pas encore : les logs sont dans la console                                                   |
+| `vercel alias`      | Pas encore : utilise la console, voir [Revenir en arrière](/docs/guides/revenir-en-arriere/) |
+| `--scope`, `--team` | Ignorés : l’organisation vient de la clé                                                     |
+
+## vercel deploy
+
+Envoie un dossier, ou un build déjà construit, et crée un déploiement. Sans option, la commande crée une preview. Avec `--prod`, elle part en production.
+
+```bash
+# Preview du dossier courant
+vercel --api https://api.host.hgdc.ch deploy
+
+# Production
+vercel --api https://api.host.hgdc.ch deploy --prod
+```
+
+Dans un script, l’adresse du déploiement est écrite seule sur la sortie standard :
+
+```bash
+URL=$(vercel --api https://api.host.hgdc.ch deploy --yes)
+echo "Preview : $URL"
+```
+
+| Option                | Rôle                                                                                        |
+| --------------------- | ------------------------------------------------------------------------------------------- |
+| `--prod`              | Déploie en production                                                                       |
+| `--prebuilt`          | Envoie `.vercel/output`, produit par `vercel build`, sans reconstruire                      |
+| `--yes`               | Répond oui à toutes les questions : relie le dossier et crée le projet. Indispensable en CI |
+| `--cwd <chemin>`      | Dossier à déployer, s’il n’est pas le dossier courant                                       |
+| `--meta <clé=valeur>` | Métadonnée attachée au déploiement                                                          |
+
+La commande affiche l’adresse du déploiement, suit la publication, puis rend la main quand le déploiement est prêt ou en erreur. Le suivi dure 9 minutes au plus.
+
+Pour un framework, construis d’abord avec `vercel build`, puis envoie le résultat avec `--prebuilt`. Utilise la même cible des deux côtés : `build --prod` avec `deploy --prebuilt --prod`, ou aucune des deux pour une preview. Sinon, la CLI refuse l’envoi.
+
+## vercel build
+
+Construit le projet en local ou en CI, au format Build Output API. Le résultat va dans `.vercel/output`, prêt pour `vercel deploy --prebuilt`.
+
+```bash
+# Build de preview
+vercel --api https://api.host.hgdc.ch build
+
+# Build de production
+vercel --api https://api.host.hgdc.ch build --prod
+```
+
+Avant de construire, la commande télécharge les variables de l’environnement visé : preview par défaut, production avec `--prod`. Une variable sensible n’est pas téléchargée depuis un poste, seulement depuis le build du dépôt GitHub.
+
+| Option           | Rôle                                                                      |
+| ---------------- | ------------------------------------------------------------------------- |
+| `--prod`         | Construit pour la production, avec les variables de production            |
+| `--yes`          | Télécharge les réglages du projet sans rien demander. Indispensable en CI |
+| `--cwd <chemin>` | Dossier du projet, s’il n’est pas le dossier courant                      |
+
+## vercel pull
+
+Télécharge les réglages du projet et les variables d’un environnement. `vercel build` s’en sert ensuite.
+
+```bash
+# Variables de développement, par défaut
+vercel --api https://api.host.hgdc.ch pull
+
+# Variables de preview ou de production
+vercel --api https://api.host.hgdc.ch pull --environment=preview
+vercel --api https://api.host.hgdc.ch pull --environment=production
+```
+
+Les variables sont écrites dans `.vercel/.env.<environnement>.local`. La CLI ajoute ce dossier au `.gitignore` : ne le commite pas.
+
+| Option           | Valeur                                   | Rôle                                                 |
+| ---------------- | ---------------------------------------- | ---------------------------------------------------- |
+| `--environment`  | `development`, `preview` ou `production` | Environnement à lire. Par défaut : `development`     |
+| `--yes`          |                                          | Relie le dossier sans rien demander                  |
+| `--cwd <chemin>` |                                          | Dossier du projet, s’il n’est pas le dossier courant |
+
+Ce que reçoit la commande dépend de la clé :
+
+| Clé                                   | Variables normales | Variables sensibles |
+| ------------------------------------- | ------------------ | ------------------- |
+| Clé d’organisation                    | Oui                | Non                 |
+| Clé de projet, posée par l’app GitHub | Oui                | Oui                 |
+
+## vercel link
+
+Relie un dossier local à un projet. Les autres commandes savent ensuite à quel projet s’adresser.
+
+```bash
+vercel --api https://api.host.hgdc.ch link
+
+# Sans question, avec le nom du dossier
+vercel --api https://api.host.hgdc.ch link --yes
+```
+
+La liaison est écrite dans `.vercel/project.json`, qui contient `orgId` et `projectId`. Le premier `link` ou `deploy` sur un nom inconnu crée le projet, sous le nom du dossier.
+
+| Option            | Rôle                                                                     |
+| ----------------- | ------------------------------------------------------------------------ |
+| `--yes`           | Relie le dossier sans rien demander, et crée le projet s’il n’existe pas |
+| `--project <nom>` | Nom du projet à relier, s’il n’est pas celui du dossier                  |
+| `--cwd <chemin>`  | Dossier à relier, s’il n’est pas le dossier courant                      |
+
+En CI, sans dossier `.vercel`, donne les deux identifiants par variables d’environnement, avec la clé :
+
+```bash
+export VERCEL_ORG_ID=…
+export VERCEL_PROJECT_ID=…
+export VERCEL_TOKEN=ah_…
+vercel --api https://api.host.hgdc.ch deploy --prod --yes
+```
+
+`VERCEL_ORG_ID` est la valeur renvoyée par [GET /v2/user](/docs/reference/api/utilisateur/). Le workflow posé par l’app GitHub contient déjà les bonnes valeurs.
+
+Pour délier un dossier, supprime son dossier `.vercel`. Le prochain déploiement te redemandera le projet.
+
+## Voir aussi
+
+- [Référence de l’API](/docs/reference/api/introduction/) : les mêmes opérations, sans la CLI.
+- [Compatibilité](/docs/reference/compatibilite/) : la liste des fonctions de la CLI et de la plateforme.

package/template/.build/reference/compatibilite/index.html

@@ -0,0 +1,196 @@
+<!DOCTYPE html><html lang="fr-CH" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-mxbotnn6"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Compatibilité avec Vercel | Host</title><style>:root{--sl-color-accent-low:#172544;--sl-color-accent:#4b8eff;--sl-color-accent-high:#87d3ff;--hgdc-on-accent:#000000;}:root:not([data-hd-theme="dark"]){--sl-color-accent-low:#dcf1ff;--sl-color-accent:#194ff7;--sl-color-accent-high:#0400bf;--hgdc-on-accent:#ffffff;}</style><link rel="shortcut icon" href="/docs/images/logo.svg" type="image/svg+xml"/><meta name="generator" content="Astro v7.3.8"/><meta name="generator" content="Starlight v0.42.6"/><meta property="og:title" content="Compatibilité avec Vercel"/><meta property="og:type" content="article"/><meta property="og:locale" content="fr-CH"/><meta property="og:description" content="Ce que la CLI et la plateforme prennent en charge aujourd'hui, ce qui est en préversion et ce qui n'existe pas encore."/><meta property="og:site_name" content="Host"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Ce que la CLI et la plateforme prennent en charge aujourd'hui, ce qui est en préversion et ce qui n'existe pas encore."/><link rel="alternate" type="text/markdown" href="/docs/reference/compatibilite.md"><link rel="describedby" type="text/markdown" href="/docs/llms.txt"><script>
+  ;(() => {
+    let stored = null
+    try {
+      stored = localStorage.getItem("starlight-theme")
+    } catch {}
+    const dark =
+      stored === "dark" || (stored === "auto" && matchMedia("(prefers-color-scheme: dark)").matches)
+    const theme = dark ? "dark" : "light"
+    document.documentElement.dataset.theme = theme
+    document.documentElement.dataset.hdTheme = theme
+    window.StarlightThemeProvider = { updatePickers() {} }
+  })()
+</script><link rel="stylesheet" href="/docs/_astro/print.ehPL0gv-.css" media="print"><link rel="stylesheet" href="/docs/_astro/common.Dx3aBIS0.css"><style>@layer starlight.components{svg:where(.astro-lgqmsw3b){color:var(--sl-icon-color);font-size:var(--sl-icon-size,1em);width:1em;height:1em;overflow:visible}}
+@layer starlight.components{starlight-tabs:where(.astro-a5blunwz){display:block}.tablist-wrapper:where(.astro-a5blunwz){overflow-x:auto}:where(.astro-a5blunwz)[role=tablist]{border-bottom:2px solid var(--sl-color-gray-5);padding:0;list-style:none;display:flex}.tab:where(.astro-a5blunwz){display:flex}.tab:where(.astro-a5blunwz)>:where(.astro-a5blunwz)[role=tab]{--sl-tab-color-border:var(--sl-color-gray-5);line-height:var(--sl-line-height-headings);box-shadow:0 2px 0 var(--sl-tab-color-border);color:var(--sl-color-gray-3);outline-offset:var(--sl-outline-offset-inside);overflow-wrap:initial;align-items:center;gap:.5rem;padding:.275rem 1.25rem;text-decoration:none;display:flex}.tab:where(.astro-a5blunwz) :where(.astro-a5blunwz)[role=tab][aria-selected=true]{--sl-tab-color-border:var(--sl-color-text-accent);color:var(--sl-color-white);font-weight:600}.tablist-wrapper:where(.astro-a5blunwz)~[role=tabpanel]{margin-top:1rem}}
+</style><script type="module" src="/docs/_astro/page.cNngjUgL.js"></script></head><body class="astro-mxbotnn6"><a class="sl-skip-link astro-k4td3kwj" href="#_top">Aller au contenu</a><div class="hd-page"><header class="hd-topbar"><div class="hd-header"><div class="hd-header__start"><button type="button" class="hd-icon-button hd-menu-button" popovertarget="starlight__sidebar" aria-label="Menu de la documentation" aria-controls="starlight__sidebar"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 7h16M4 12h16M4 17h10"></path></svg></button><a class="hd-brand" href="/docs/"><span class="hd-brand__mark"><img class="hd-brand__light" src="/docs/images/logo.svg" alt="" width="24" height="24"><img class="hd-brand__dark" src="/docs/images/logo.svg" alt="" width="24" height="24"></span><span class="hd-brand__name">Host</span></a></div><div class="hd-header__end"><hd-search data-base="/docs" data-assistant><button type="button" class="hd-search-trigger" data-open aria-haspopup="dialog" aria-label="Rechercher (Ctrl K)"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M11 18a7 7 0 1 0 0-14 7 7 0 0 0 0 14Zm5-2 4 4"></path></svg><span class="hd-search-trigger__label">Rechercher</span><kbd class="hd-kbd" data-shortcut>Ctrl K</kbd></button><dialog class="hd-palette" aria-label="Rechercher dans la documentation"><div class="hd-palette__box"><div class="hd-palette__field"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M11 18a7 7 0 1 0 0-14 7 7 0 0 0 0 14Zm5-2 4 4"></path></svg><input type="search" data-input placeholder="Rechercher dans la documentation" autocomplete="off" spellcheck="false" role="combobox" aria-expanded="false" aria-controls="hd-palette-results" aria-autocomplete="list"><button type="button" class="hd-kbd hd-kbd--button" data-close>Échap</button></div><div class="hd-palette__results" id="hd-palette-results" role="listbox" aria-label="Résultats" data-results></div><p class="hd-palette__status" data-status role="status">Tape un mot pour chercher dans les pages.</p><footer class="hd-palette__hints" aria-hidden="true"><span><kbd class="hd-kbd">↑</kbd><kbd class="hd-kbd">↓</kbd> Choisir</span><span><kbd class="hd-kbd">↵</kbd> Ouvrir</span><span><kbd class="hd-kbd">Échap</kbd> Fermer</span></footer></div></dialog></hd-search><script type="module" src="/docs/_astro/Search.astro_astro_type_script_index_0_lang.D7EcezBU.js"></script><button type="button" class="hd-icon-button" data-hgdc-ask aria-label="Demander à l'assistant" title="Demander à l'assistant (Ctrl I)"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3.5 13.6 8a3 3 0 0 0 1.9 1.9L20 11.5l-4.5 1.6a3 3 0 0 0-1.9 1.9L12 19.5 10.4 15a3 3 0 0 0-1.9-1.9L4 11.5 8.5 9.9A3 3 0 0 0 10.4 8ZM19 3v3M20.5 4.5h-3"></path></svg></button><button type="button" class="hd-icon-button hd-theme-button" data-hd-theme-toggle aria-label="Passer au thème sombre"><svg class="hd-icon hd-theme-button__moon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M20 14.5A8 8 0 1 1 9.5 4a6.5 6.5 0 0 0 10.5 10.5Z"></path></svg><svg class="hd-icon hd-theme-button__sun" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 16a4 4 0 1 0 0-8 4 4 0 0 0 0 8ZM12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4"></path></svg></button><script type="module">var e=`starlight-theme`,t=()=>{try{return localStorage.getItem(e)||`light`}catch{return`light`}},n=()=>matchMedia(`(prefers-color-scheme: light)`).matches?`light`:`dark`,r=t=>{try{localStorage.setItem(e,t)}catch{}let r=t===`auto`?n():t;document.documentElement.dataset.theme=r,document.documentElement.dataset.hdTheme=r,i()},i=()=>{let e=t(),n=document.documentElement.dataset.theme===`dark`;for(let e of document.querySelectorAll(`[data-hd-theme-toggle]`))e.setAttribute(`aria-label`,n?`Passer au thème clair`:`Passer au thème sombre`);for(let t of document.querySelectorAll(`[data-hd-theme]`)){let n=t.dataset.hdTheme===e;t.setAttribute(`aria-checked`,String(n)),t.tabIndex=n?0:-1}};for(let e of document.querySelectorAll(`[data-hd-theme-toggle]`))e.addEventListener(`click`,()=>r(document.documentElement.dataset.theme===`dark`?`light`:`dark`));for(let e of document.querySelectorAll(`.hd-theme-choice`)){let t=[...e.querySelectorAll(`[data-hd-theme]`)];for(let e of t)e.addEventListener(`click`,()=>r(e.dataset.hdTheme));e.addEventListener(`keydown`,e=>{let n=e.key===`ArrowRight`||e.key===`ArrowDown`?1:e.key===`ArrowLeft`||e.key===`ArrowUp`?-1:0;if(!n)return;e.preventDefault();let i=t.findIndex(e=>e.getAttribute(`aria-checked`)===`true`),a=t[(i+n+t.length)%t.length];r(a.dataset.hdTheme),a.focus()})}matchMedia(`(prefers-color-scheme: light)`).addEventListener(`change`,()=>{t()===`auto`&&r(`auto`)}),i();</script></div></div></header><nav class="hd-sidebar" aria-label="Navigation de la documentation"><script type="module">for(let e of document.querySelectorAll(`[data-hgdc-version]`))e.addEventListener(`change`,()=>window.location.assign(e.value));var e=document.querySelector(`.sidebar-pane`);if(e){let t=`hd-sidebar-scroll`;try{let n=Number(sessionStorage.getItem(t));n&&(e.scrollTop=n)}catch{}let n=e.querySelector(`[aria-current="page"]`);if(n){let t=e.getBoundingClientRect(),r=n.getBoundingClientRect();(r.top<t.top||r.bottom>t.bottom)&&n.scrollIntoView({block:`center`})}addEventListener(`pagehide`,()=>{try{sessionStorage.setItem(t,String(e.scrollTop))}catch{}})}</script><hd-sidebar-pane popover="auto" id="starlight__sidebar" class="sidebar-pane"><div class="hd-sidebar__content"><div class="hd-mobile-only hd-sidebar-head"><a class="hd-brand" href="/docs/"><span class="hd-brand__name">Host</span></a><button type="button" class="hd-icon-button" popovertarget="starlight__sidebar" popovertargetaction="hide" aria-label="Fermer le menu"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M6 6l12 12M18 6 6 18"></path></svg></button></div><ul class="hd-nav hd-nav--depth-0"><li class="hd-nav__group"><p class="hd-nav__heading">Démarrer</p><ul class="hd-nav hd-nav--depth-1"><li><a href="/docs/" class="hd-nav__link"><span>Accueil</span></a></li><li><a href="/docs/demarrer/premier-site/" class="hd-nav__link"><span>Premier site</span></a></li><li><a href="/docs/demarrer/depuis-github/" class="hd-nav__link"><span>Depuis GitHub</span></a></li></ul></li><li class="hd-nav__group"><p class="hd-nav__heading">Guides</p><ul class="hd-nav hd-nav--depth-1"><li><a href="/docs/guides/cle-d-api/" class="hd-nav__link"><span>Clés d&#39;API</span></a></li><li><a href="/docs/guides/deployer-depuis-github/" class="hd-nav__link"><span>Depuis GitHub</span></a></li><li><a href="/docs/guides/github-actions-sans-application/" class="hd-nav__link"><span>GitHub Actions sans l&#39;app</span></a></li><li><a href="/docs/guides/deployer-un-framework/" class="hd-nav__link"><span>Un framework</span></a></li><li><a href="/docs/guides/site-statique/" class="hd-nav__link"><span>Site statique</span></a></li><li><a href="/docs/guides/monorepo/" class="hd-nav__link"><span>Monorepo</span></a></li><li><a href="/docs/guides/brancher-un-domaine/" class="hd-nav__link"><span>Brancher un domaine</span></a></li><li><a href="/docs/guides/variables-d-environnement/" class="hd-nav__link"><span>Variables</span></a></li><li><a href="/docs/guides/synchroniser-doppler/" class="hd-nav__link"><span>Doppler</span></a></li><li><a href="/docs/guides/revenir-en-arriere/" class="hd-nav__link"><span>Revenir en arrière</span></a></li><li><a href="/docs/guides/inviter-une-personne/" class="hd-nav__link"><span>Inviter une personne</span></a></li><li><a href="/docs/guides/lire-les-logs/" class="hd-nav__link"><span>Lire les logs</span></a></li><li><a href="/docs/guides/migrer-depuis-vercel/" class="hd-nav__link"><span>Migrer depuis Vercel</span></a></li><li><a href="/docs/guides/depannage/" class="hd-nav__link"><span>Dépannage</span></a></li></ul></li><li class="hd-nav__group"><p class="hd-nav__heading">Référence</p><ul class="hd-nav hd-nav--depth-1"><li><a href="/docs/reference/cli/" class="hd-nav__link"><span>CLI</span></a></li><li><a href="/docs/reference/variables/" class="hd-nav__link"><span>Variables</span></a></li><li><a href="/docs/reference/domaines/" class="hd-nav__link"><span>Domaines</span></a></li><li><a href="/docs/reference/vercel-json/" class="hd-nav__link"><span>vercel.json</span></a></li><li><a href="/docs/reference/compatibilite/" class="hd-nav__link" aria-current="page"><span>Compatibilité</span></a></li><li><a href="/docs/reference/limites/" class="hd-nav__link"><span>Limites</span></a></li><li><details class="hd-nav__fold" open><summary class="hd-nav__link"><span>API</span><svg class="hd-icon hd-nav__chevron" aria-hidden="true" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="m9 6 6 6-6 6"></path></svg></summary><ul class="hd-nav hd-nav--depth-2"><li><a href="/docs/reference/api/introduction/" class="hd-nav__link"><span>Introduction</span></a></li><li><a href="/docs/reference/api/erreurs/" class="hd-nav__link"><span>Erreurs</span></a></li><li><a href="/docs/reference/api/utilisateur/" class="hd-nav__link"><span>Utilisateur et organisation</span></a></li><li><a href="/docs/reference/api/projets/" class="hd-nav__link"><span>Projets</span></a></li><li><a href="/docs/reference/api/deploiements/" class="hd-nav__link"><span>Déploiements</span></a></li><li><a href="/docs/reference/api/fichiers/" class="hd-nav__link"><span>Envoyer un fichier</span></a></li><li><a href="/docs/reference/api/variables/" class="hd-nav__link"><span>Variables</span></a></li></ul></details></li></ul></li><li class="hd-nav__group"><p class="hd-nav__heading">Concepts</p><ul class="hd-nav hd-nav--depth-1"><li><a href="/docs/concepts/deploiements/" class="hd-nav__link"><span>Déploiements</span></a></li><li><a href="/docs/concepts/organisations-et-roles/" class="hd-nav__link"><span>Organisations et rôles</span></a></li><li><a href="/docs/concepts/secrets-et-coffre/" class="hd-nav__link"><span>Secrets et coffre</span></a></li><li><a href="/docs/concepts/preversion/" class="hd-nav__link"><span>Préversion</span></a></li><li><a href="/docs/concepts/confidentialite/" class="hd-nav__link"><span>Sécurité et confidentialité</span></a></li></ul></li></ul><div class="hd-mobile-only hd-sidebar-footer"><div class="hd-theme-choice" role="radiogroup" aria-label="Thème"><button type="button" role="radio" aria-checked="false" data-hd-theme="auto" aria-label="Système" title="Système"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 5h16a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1Zm4 15h8m-4-3v3"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme="light" aria-label="Clair" title="Clair"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 16a4 4 0 1 0 0-8 4 4 0 0 0 0 8ZM12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme="dark" aria-label="Sombre" title="Sombre"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M20 14.5A8 8 0 1 1 9.5 4a6.5 6.5 0 0 0 10.5 10.5Z"></path></svg></button></div></div></div></hd-sidebar-pane></nav><div class="hd-main-frame main-frame"><script type="module">var e=document.getElementById(`starlight__sidebar`),t=e?.querySelector(`sl-sidebar-state-persist`),n=`sl-sidebar-state`,r=()=>{let r=[],i=t?.dataset.hash||``;try{let e=sessionStorage.getItem(n),t=JSON.parse(e||`{}`);Array.isArray(t.open)&&t.hash===i&&(r=t.open)}catch{}return{hash:i,open:r,scroll:e?.scrollTop||0}},i=e=>{try{sessionStorage.setItem(n,JSON.stringify(e))}catch{}},a=()=>i(r()),o=(e,t)=>{let n=r();n.open[t]=e,i(n)};t?.addEventListener(`click`,e=>{if(!(e.target instanceof Element))return;let t=e.target.closest(`summary`)?.closest(`details`);if(!t)return;let n=t.querySelector(`sl-sidebar-restore`),r=parseInt(n?.dataset.index||``);isNaN(r)||o(!t.open,r)}),addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`&&a()});</script><div class="hd-columns hd-columns--toc"><div class="hd-columns__main main-pane"><main data-pagefind-body class="astro-mxbotnn6" lang="fr-CH" dir="ltr"><div class="content-panel astro-64cflj2q"><div class="sl-container astro-64cflj2q"><div class="hd-title not-content"><p class="hd-eyebrow" data-pagefind-meta="section">Référence</p><div class="hd-title__row"><h1 id="_top">Compatibilité avec Vercel</h1><div class="hd-page-actions" data-hgdc-skip data-pagefind-ignore><div class="hd-split"><button type="button" class="hd-split__main" data-hgdc-copy="/docs/reference/compatibilite.md"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M9 9h10a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1V10a1 1 0 0 1 1-1Zm-4 6H4.5A1.5 1.5 0 0 1 3 13.5v-9A1.5 1.5 0 0 1 4.5 3h9A1.5 1.5 0 0 1 15 4.5V5"></path></svg><span data-label>Copier la page</span></button><details class="hd-menu"><summary class="hd-split__more" aria-label="Autres formats de la page"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="m6 9 6 6 6-6"></path></svg></summary><ul class="hd-menu__list"><li><button type="button" data-hgdc-copy-item><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M9 9h10a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1V10a1 1 0 0 1 1-1Zm-4 6H4.5A1.5 1.5 0 0 1 3 13.5v-9A1.5 1.5 0 0 1 4.5 3h9A1.5 1.5 0 0 1 15 4.5V5"></path></svg><span><strong>Copier la page</strong><small>En Markdown, pour un LLM</small></span></button></li><li><a href="/docs/reference/compatibilite.md"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 6h16a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7a1 1 0 0 1 1-1Zm3 9V9l2.5 3L12 9v6m5-6v6m-2-2 2 2 2-2"></path></svg><span><strong>Voir en Markdown</strong><small>La page en texte brut</small></span></a></li><li><a data-hgdc-open="claude" href="https://claude.ai/new" target="_blank" rel="noopener"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M7 17 17 7M8 7h9v9"></path></svg><span><strong>Ouvrir dans Claude</strong><small>Poser une question sur cette page</small></span></a></li><li><a data-hgdc-open="chatgpt" href="https://chatgpt.com/" target="_blank" rel="noopener"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M7 17 17 7M8 7h9v9"></path></svg><span><strong>Ouvrir dans ChatGPT</strong><small>Poser une question sur cette page</small></span></a></li><li><a href="/docs/llms.txt"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M14 3H7a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8Zm0 0v5h5M9 13h6m-6 4h4"></path></svg><span><strong>llms.txt</strong><small>L'index de la doc pour les agents</small></span></a></li></ul></details></div><span class="sr-only" role="status" aria-live="polite" data-hgdc-copy-status></span></div></div><p class="hd-lead">Ce que la CLI et la plateforme prennent en charge aujourd&#39;hui, ce qui est en préversion et ce qui n&#39;existe pas encore.</p></div><script type="module">var e=document.querySelector(`[data-hgdc-copy-status]`),t=document.querySelector(`[data-hgdc-copy]`);async function n(){if(!t)return;let n=t.querySelector(`[data-label]`),r=t=>{n.textContent=t,e&&(e.textContent=t),setTimeout(()=>n.textContent=`Copier la page`,2e3)};try{let e=await fetch(t.dataset.hgdcCopy);if(!e.ok)throw Error(String(e.status));await navigator.clipboard.writeText(await e.text()),r(`Page copiée`)}catch{r(`Copie impossible`)}}if(t?.addEventListener(`click`,()=>void n()),document.querySelector(`[data-hgdc-copy-item]`)?.addEventListener(`click`,()=>{document.querySelector(`.hd-menu`).open=!1,n()}),t){let e=`Lis ${new URL(t.dataset.hgdcCopy,location.href).href} et réponds à mes questions sur cette page.`;for(let t of document.querySelectorAll(`[data-hgdc-open]`))t.href=`${t.dataset.hgdcOpen===`claude`?`https://claude.ai/new`:`https://chatgpt.com/`}?q=${encodeURIComponent(e)}`}for(let e of document.querySelectorAll(`.hd-menu`))document.addEventListener(`click`,t=>{e.open&&!e.contains(t.target)&&(e.open=!1)}),e.addEventListener(`keydown`,t=>{t.key===`Escape`&&e.open&&(t.stopPropagation(),e.open=!1,e.querySelector(`summary`)?.focus())});</script></div></div><div class="content-panel astro-64cflj2q"><div class="sl-container astro-64cflj2q"><div class="sl-markdown-content"><p>Host implémente la partie de l’API Vercel qu’utilise la CLI pour relier un projet, récupérer ses variables, construire et déployer. La CLI officielle, version 63, est la référence de test.</p>
+<p>Cette page dit ce qui marche aujourd’hui. Elle distingue trois états :</p>
+<ul>
+<li><strong>Pris en charge</strong> : utilisable en production.</li>
+<li><strong>En préversion</strong> : utilisable, mais ouvert organisation par organisation. Une organisation qui n’en profite pas encore reçoit une réponse <code>501</code>.</li>
+<li><strong>Pas encore</strong> : absent de Host pour le moment.</li>
+</ul>
+<h2 id="commandes-de-la-cli">Commandes de la CLI</h2>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="hd-table"><table><thead><tr><th>Commande</th><th>État</th></tr></thead><tbody><tr><td><code>vercel deploy</code>, avec <code>--prod</code> et <code>--prebuilt</code></td><td>Pris en charge</td></tr><tr><td><code>vercel build</code></td><td>Pris en charge : télécharge les variables de l’environnement visé</td></tr><tr><td><code>vercel pull</code></td><td>Pris en charge : réglages et variables</td></tr><tr><td><code>vercel link</code></td><td>Pris en charge</td></tr><tr><td><code>vercel login</code></td><td>Non : la connexion passe par la clé, dans <code>VERCEL_TOKEN</code> ou <code>--token</code></td></tr><tr><td><code>vercel env</code></td><td>Pas encore : gère les variables dans la console</td></tr><tr><td><code>vercel domains</code></td><td>Pas encore : gère les domaines dans la console</td></tr><tr><td><code>vercel logs</code></td><td>Pas encore : les logs sont dans la console</td></tr><tr><td><code>vercel env add</code></td><td>Pas encore : ajoute les variables dans la console</td></tr></tbody></table></div>
+<h2 id="fonctions-de-la-plateforme">Fonctions de la plateforme</h2>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="hd-table"><table><thead><tr><th>Fonction</th><th>État</th></tr></thead><tbody><tr><td>Fichiers statiques, Build Output API v3</td><td>Pris en charge</td></tr><tr><td>Routage de <code>vercel.json</code> et de <code>config.json</code></td><td>Pris en charge, voir <a href="/docs/reference/vercel-json/">vercel.json</a></td></tr><tr><td>Pages pré-rendues de Next.js</td><td>Prises en charge</td></tr><tr><td>Draft mode</td><td>Pris en charge</td></tr><tr><td>Domaines, redirections, certificats</td><td>Pris en charge</td></tr><tr><td>Réécritures vers une URL externe</td><td>Prises en charge</td></tr><tr><td>Variables d’environnement, variables sensibles</td><td>Prises en charge</td></tr><tr><td>Rendu à la demande (SSR), routes d’API, Server Actions</td><td>En préversion : fonctions Node, ouvertes organisation par organisation</td></tr><tr><td>Proxy (ex-middleware) et middleware Node.js</td><td>En préversion</td></tr><tr><td>Fonctions et middleware en runtime edge</td><td>En préversion</td></tr><tr><td>ISR (régénération incrémentale)</td><td>En préversion : cache par serveur, vidé à son redémarrage</td></tr><tr><td>Optimisation d’images</td><td>Pas encore : l’image d’origine est servie, sans redimensionnement</td></tr><tr><td>Crons</td><td>En préversion : production seulement, avec <code>CRON_SECRET</code></td></tr></tbody></table></div>
+<p>Le détail du fonctionnement de la préversion est dans <a href="/docs/concepts/preversion/">Préversion et rendu à la demande</a>.</p>
+<h2 id="frameworks">Frameworks</h2>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="hd-table"><table><thead><tr><th>Framework</th><th>Ce qui est servi</th><th>Commande de build</th></tr></thead><tbody><tr><td>Site statique (HTML, CSS, JS)</td><td>Le dossier tel quel</td><td>Aucune : <code>vercel deploy</code></td></tr><tr><td>Astro</td><td>Les pages générées, et en préversion le rendu à la demande, les routes d’API, le middleware et l’ISR</td><td><code>vercel build</code></td></tr><tr><td>Vite (React, Vue, Svelte…)</td><td>Le build de l’application</td><td><code>vercel build</code></td></tr><tr><td>SvelteKit</td><td>Les pages pré-rendues, et en préversion le rendu à la demande, les routes d’API, les actions de formulaire et l’ISR</td><td><code>vercel build</code></td></tr><tr><td>Nuxt</td><td>Les pages générées, et en préversion le rendu à la demande, les routes d’API, le middleware serveur et l’ISR</td><td><code>vercel build</code></td></tr><tr><td>TanStack Start</td><td>Les pages pré-rendues</td><td><code>vercel build</code></td></tr><tr><td>React Router</td><td>Les pages pré-rendues</td><td><code>vercel build</code></td></tr><tr><td>Next.js</td><td>Les pages pré-rendues et leur navigation, et en préversion le rendu à la demande, les routes d’API, le proxy, l’ISR et les routes en runtime edge</td><td><code>vercel build</code></td></tr><tr><td>Documentation <code>@hgdc/docs</code></td><td>Le site de documentation, chaque page en Markdown (<code>.md</code>), <code>llms.txt</code> et le corpus de l’assistant</td><td><code>hgdc-docs build</code></td></tr></tbody></table></div>
+<p>Pour tout framework, la séquence est la même : construis, puis envoie le résultat avec <code>--prebuilt</code>. Voir <a href="/docs/guides/deployer-un-framework/">Déployer un framework</a>.</p>
+<h2 id="ce-que-cette-page-ne-couvre-pas">Ce que cette page ne couvre pas</h2>
+<ul>
+<li>Ce qui n’est pas listé ici n’est pas garanti. Ne suppose pas qu’une fonctionnalité de Vercel marche sur Host sans l’avoir testée.</li>
+<li>Les limites chiffrées, comme la taille des fichiers ou les débits, sont sur <a href="/docs/reference/limites/">Limites</a>.</li>
+</ul></div><hgdc-feedback class="hgdc-feedback not-content" data-endpoint="https://docs.hgdc.ch/api/v1/feedback" data-project="js743wp3001k1jvrdad0fwcjx18gc789" data-pagefind-ignore="true"><div data-step="ask"><p class="hgdc-feedback__question">Cette page t'a aidé ?</p><div class="hgdc-feedback__choices"><button type="button" data-helpful="true"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M7 10v11M15 5.9 14 10h5.8a2 2 0 0 1 1.9 2.5l-2.3 7A2 2 0 0 1 17.5 21H4a1 1 0 0 1-1-1v-9a1 1 0 0 1 1-1h2.8a2 2 0 0 0 1.8-1.1L12 2a3.1 3.1 0 0 1 3 3.9Z"></path></svg>Oui</button><button type="button" data-helpful="false"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M17 14V3M9 18.1 10 14H4.2a2 2 0 0 1-1.9-2.5l2.3-7A2 2 0 0 1 6.5 3H20a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1h-2.8a2 2 0 0 0-1.8 1.1L12 22a3.1 3.1 0 0 1-3-3.9Z"></path></svg>Non</button></div></div><form data-step="comment" hidden><label for="hgdc-feedback-comment">Qu'est-ce qui manquait ou pourrait être plus clair ? (facultatif)</label><textarea id="hgdc-feedback-comment" name="comment" rows="3" maxlength="1000"></textarea><div class="hgdc-feedback__choices"><button type="submit">Envoyer</button><button type="button" data-skip>Passer</button></div></form><p data-step="done" class="hgdc-feedback__done" role="status" hidden>Merci, c'est noté.</p></hgdc-feedback><nav class="hd-pagination not-content" aria-label="Pages voisines" data-pagefind-ignore><a class="hd-pagination__link" href="/docs/reference/vercel-json/" rel="prev"><span class="hd-pagination__hint"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="m15 6-6 6 6 6"></path></svg>Précédent</span><span class="hd-pagination__title">vercel.json</span></a><a class="hd-pagination__link hd-pagination__link--next" href="/docs/reference/limites/" rel="next"><span class="hd-pagination__hint">Suivant<svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="m9 6 6 6-6 6"></path></svg></span><span class="hd-pagination__title">Limites</span></a></nav><script type="module" src="/docs/_astro/Footer.astro_astro_type_script_index_0_lang.DzCnn3OT.js"></script></div></div></main><form class="hd-askbar" data-askbar data-pagefind-ignore><label class="sr-only" for="hd-askbar-input">Pose une question à l'assistant</label><input id="hd-askbar-input" data-askbar-input type="text" maxlength="1000" placeholder="Pose une question…" autocomplete="off"><kbd class="hd-kbd" data-shortcut aria-hidden="true">Ctrl I</kbd><button type="submit" class="hd-send" aria-label="Envoyer la question"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 19V5m-6 6 6-6 6 6"></path></svg></button></form></div><aside class="hd-columns__toc" aria-label="Sur cette page"><div class="hd-toc-scroll"><starlight-toc data-min-h="2" data-max-h="3"><nav aria-labelledby="starlight__on-this-page"><h2 id="starlight__on-this-page">Sur cette page</h2><ul class="astro-jxyovztp" style="--depth: 0;"><li style="--depth: 0;" class="astro-jxyovztp"><a href="#_top" style="--depth: 0;" class="astro-jxyovztp"><span style="--depth: 0;" class="astro-jxyovztp">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-jxyovztp"><a href="#commandes-de-la-cli" style="--depth: 0;" class="astro-jxyovztp"><span style="--depth: 0;" class="astro-jxyovztp">Commandes de la CLI</span></a></li><li style="--depth: 0;" class="astro-jxyovztp"><a href="#fonctions-de-la-plateforme" style="--depth: 0;" class="astro-jxyovztp"><span style="--depth: 0;" class="astro-jxyovztp">Fonctions de la plateforme</span></a></li><li style="--depth: 0;" class="astro-jxyovztp"><a href="#frameworks" style="--depth: 0;" class="astro-jxyovztp"><span style="--depth: 0;" class="astro-jxyovztp">Frameworks</span></a></li><li style="--depth: 0;" class="astro-jxyovztp"><a href="#ce-que-cette-page-ne-couvre-pas" style="--depth: 0;" class="astro-jxyovztp"><span style="--depth: 0;" class="astro-jxyovztp">Ce que cette page ne couvre pas</span></a></li></ul></nav></starlight-toc><script type="module">var e=`_top`,t=class extends HTMLElement{_current=this.querySelector(`a[aria-current="true"]`);minH=parseInt(this.dataset.minH||`2`,10);maxH=parseInt(this.dataset.maxH||`3`,10);tocHeadingSelector=`h1#${e},:where(${[...Array.from({length:1+this.maxH-this.minH}).map((e,t)=>`h${this.minH+t}`)].join()})[id]`;set current(e){e!==this._current&&(this._current&&this._current.removeAttribute(`aria-current`),e.setAttribute(`aria-current`,`true`),this._current=e)}onIdle=e=>(window.requestIdleCallback||(e=>setTimeout(e,1)))(e);constructor(){super(),this.onIdle(()=>this.init())}init=()=>{let t=[...this.querySelectorAll(`a`)],n=e=>e.matches(this.tocHeadingSelector),r=t=>{for(;t;){if(t.matches(`.sl-markdown-content, main > *`))return document.getElementById(e);if(n(t))return t;let r=t.querySelector(this.tocHeadingSelector);if(r)return r;let i=t.previousElementSibling;for(;i?.lastElementChild;)i=i.lastElementChild;t=i??t.parentElement}return null},i=e=>{for(let{isIntersecting:n,target:i}of e){if(!n)continue;let e=r(i);if(!e)continue;let a=t.find(t=>t.hash===`#`+encodeURIComponent(e.id));if(a){this.current=a;break}}},a=document.querySelectorAll([`main :where(${this.tocHeadingSelector})`,`main :where(${this.tocHeadingSelector}, .sl-heading-wrapper) ~ *:not(:has(${this.tocHeadingSelector}))`,`main .sl-markdown-content > *:not(:has(${this.tocHeadingSelector}))`,`main > *:not(:has(${this.tocHeadingSelector}))`].join()),o,s=()=>{o||(o=new IntersectionObserver(i,{rootMargin:this.getRootMargin()}),a.forEach(e=>o.observe(e)))};s();let c;window.addEventListener(`resize`,()=>{o&&=(o.disconnect(),void 0),clearTimeout(c),c=setTimeout(()=>this.onIdle(s),200)})};getRootMargin(){let e=(document.querySelector(`header`)?.getBoundingClientRect().height||0)+(this.querySelector(`summary`)?.getBoundingClientRect().height||0)+32;return`-${e}px 0% ${e+53-document.documentElement.clientHeight}px`}};customElements.define(`starlight-toc`,t);</script></div></aside></div><footer class="hd-site-footer" data-pagefind-ignore><div class="hd-site-footer__row"><a class="hd-brand hd-brand--footer" href="/docs/"><span class="hd-brand__mark"><img class="hd-brand__light" src="/docs/images/logo.svg" alt="" width="20" height="20" loading="lazy"><img class="hd-brand__dark" src="/docs/images/logo.svg" alt="" width="20" height="20" loading="lazy"></span><span class="hd-brand__name">Host</span></a></div><div class="hd-site-footer__row hd-site-footer__row--meta"><p>Ton site en ligne, déployé à chaque modification.</p><div class="hd-theme-choice" role="radiogroup" aria-label="Thème"><button type="button" role="radio" aria-checked="false" data-hd-theme="auto" aria-label="Système" title="Système"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 5h16a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1Zm4 15h8m-4-3v3"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme="light" aria-label="Clair" title="Clair"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 16a4 4 0 1 0 0-8 4 4 0 0 0 0 8ZM12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme="dark" aria-label="Sombre" title="Sombre"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M20 14.5A8 8 0 1 1 9.5 4a6.5 6.5 0 0 0 10.5 10.5Z"></path></svg></button></div></div></footer></div><hgdc-assistant data-endpoint="https://docs.hgdc.ch/api/v1/ask" data-project="js743wp3001k1jvrdad0fwcjx18gc789" data-name="Host"><section class="hgdc-panel" role="dialog" aria-modal="false" aria-labelledby="hgdc-assistant-title" data-panel inert><div class="hgdc-panel__grip" aria-hidden="true"></div><header class="hgdc-panel__header"><h2 id="hgdc-assistant-title"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3.5 13.6 8a3 3 0 0 0 1.9 1.9L20 11.5l-4.5 1.6a3 3 0 0 0-1.9 1.9L12 19.5 10.4 15a3 3 0 0 0-1.9-1.9L4 11.5 8.5 9.9A3 3 0 0 0 10.4 8ZM19 3v3M20.5 4.5h-3"></path></svg>Assistant</h2><div class="hgdc-panel__tools"><button type="button" class="hd-icon-button" data-reset aria-label="Nouvelle conversation" title="Nouvelle conversation" hidden><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 12a8 8 0 1 0 2.3-5.7M4 4v4h4"></path></svg></button><button type="button" class="hd-icon-button" data-close aria-label="Fermer l'assistant" title="Fermer (Échap)"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M6 6l12 12M18 6 6 18"></path></svg></button></div></header><div class="hgdc-panel__body" data-log aria-live="polite"><div class="hgdc-empty" data-empty><p class="hgdc-empty__title">Pose ta question sur Host.</p><p>Je cherche dans les pages de cette documentation et je cite mes sources. Si la réponse n'y est pas, je te le dis.</p></div></div><form class="hgdc-panel__form" data-form><label class="sr-only" for="hgdc-question">Ta question</label><textarea id="hgdc-question" data-input rows="1" maxlength="1000" placeholder="Pose une question…" required></textarea><button type="submit" class="hd-send" data-send aria-label="Envoyer la question"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 19V5m-6 6 6-6 6 6"></path></svg></button></form><p class="hgdc-panel__note">Réponses générées par IA (Claude, d'Anthropic), à vérifier. Les questions sont conservées 90 jours pour améliorer cette documentation.</p></section></hgdc-assistant><script type="module" src="/docs/_astro/Assistant.astro_astro_type_script_index_0_lang.C1pz7yK1.js"></script></div><script type="module">var e=class extends HTMLElement{connectedCallback(){let e=matchMedia(`(min-width: 50em)`),t=()=>{e.matches&&this.matches(`:popover-open`)&&this.hidePopover(),this.popover=e.matches?null:`auto`};t(),e.addEventListener(`change`,t),this.addEventListener(`toggle`,e=>{let t=e.newState===`open`;for(let e of document.querySelectorAll(`.hd-main-frame, .hd-askbar`))e.toggleAttribute(`inert`,t);document.documentElement.toggleAttribute(`data-hd-menu`,t)}),this.addEventListener(`click`,e=>{e.target.closest(`a`)&&this.matches(`:popover-open`)&&this.hidePopover()})}};customElements.define(`hd-sidebar-pane`,e);</script></body></html>

package/template/.build/reference/compatibilite.md

@@ -0,0 +1,64 @@
+# Compatibilité avec Vercel
+
+Host implémente la partie de l’API Vercel qu’utilise la CLI pour relier un projet, récupérer ses variables, construire et déployer. La CLI officielle, version 63, est la référence de test.
+
+Cette page dit ce qui marche aujourd’hui. Elle distingue trois états :
+
+- **Pris en charge** : utilisable en production.
+- **En préversion** : utilisable, mais ouvert organisation par organisation. Une organisation qui n’en profite pas encore reçoit une réponse `501`.
+- **Pas encore** : absent de Host pour le moment.
+
+## Commandes de la CLI
+
+| Commande                                       | État                                                                  |
+| ---------------------------------------------- | --------------------------------------------------------------------- |
+| `vercel deploy`, avec `--prod` et `--prebuilt` | Pris en charge                                                        |
+| `vercel build`                                 | Pris en charge : télécharge les variables de l’environnement visé     |
+| `vercel pull`                                  | Pris en charge : réglages et variables                                |
+| `vercel link`                                  | Pris en charge                                                        |
+| `vercel login`                                 | Non : la connexion passe par la clé, dans `VERCEL_TOKEN` ou `--token` |
+| `vercel env`                                   | Pas encore : gère les variables dans la console                       |
+| `vercel domains`                               | Pas encore : gère les domaines dans la console                        |
+| `vercel logs`                                  | Pas encore : les logs sont dans la console                            |
+| `vercel env add`                               | Pas encore : ajoute les variables dans la console                     |
+
+## Fonctions de la plateforme
+
+| Fonction                                               | État                                                                   |
+| ------------------------------------------------------ | ---------------------------------------------------------------------- |
+| Fichiers statiques, Build Output API v3                | Pris en charge                                                         |
+| Routage de `vercel.json` et de `config.json`           | Pris en charge, voir [vercel.json](/docs/reference/vercel-json/)       |
+| Pages pré-rendues de Next.js                           | Prises en charge                                                       |
+| Draft mode                                             | Pris en charge                                                         |
+| Domaines, redirections, certificats                    | Pris en charge                                                         |
+| Réécritures vers une URL externe                       | Prises en charge                                                       |
+| Variables d’environnement, variables sensibles         | Prises en charge                                                       |
+| Rendu à la demande (SSR), routes d’API, Server Actions | En préversion : fonctions Node, ouvertes organisation par organisation |
+| Proxy (ex-middleware) et middleware Node.js            | En préversion                                                          |
+| Fonctions et middleware en runtime edge                | En préversion                                                          |
+| ISR (régénération incrémentale)                        | En préversion : cache par serveur, vidé à son redémarrage              |
+| Optimisation d’images                                  | Pas encore : l’image d’origine est servie, sans redimensionnement      |
+| Crons                                                  | En préversion : production seulement, avec `CRON_SECRET`               |
+
+Le détail du fonctionnement de la préversion est dans [Préversion et rendu à la demande](/docs/concepts/preversion/).
+
+## Frameworks
+
+| Framework                     | Ce qui est servi                                                                                                                                  | Commande de build        |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
+| Site statique (HTML, CSS, JS) | Le dossier tel quel                                                                                                                               | Aucune : `vercel deploy` |
+| Astro                         | Les pages générées, et en préversion le rendu à la demande, les routes d’API, le middleware et l’ISR                                              | `vercel build`           |
+| Vite (React, Vue, Svelte…)    | Le build de l’application                                                                                                                         | `vercel build`           |
+| SvelteKit                     | Les pages pré-rendues, et en préversion le rendu à la demande, les routes d’API, les actions de formulaire et l’ISR                               | `vercel build`           |
+| Nuxt                          | Les pages générées, et en préversion le rendu à la demande, les routes d’API, le middleware serveur et l’ISR                                      | `vercel build`           |
+| TanStack Start                | Les pages pré-rendues                                                                                                                             | `vercel build`           |
+| React Router                  | Les pages pré-rendues                                                                                                                             | `vercel build`           |
+| Next.js                       | Les pages pré-rendues et leur navigation, et en préversion le rendu à la demande, les routes d’API, le proxy, l’ISR et les routes en runtime edge | `vercel build`           |
+| Documentation `@hgdc/docs`    | Le site de documentation, chaque page en Markdown (`.md`), `llms.txt` et le corpus de l’assistant                                                 | `hgdc-docs build`        |
+
+Pour tout framework, la séquence est la même : construis, puis envoie le résultat avec `--prebuilt`. Voir [Déployer un framework](/docs/guides/deployer-un-framework/).
+
+## Ce que cette page ne couvre pas
+
+- Ce qui n’est pas listé ici n’est pas garanti. Ne suppose pas qu’une fonctionnalité de Vercel marche sur Host sans l’avoir testée.
+- Les limites chiffrées, comme la taille des fichiers ou les débits, sont sur [Limites](/docs/reference/limites/).